W-Agent

W-Agent Agent API：OpenAPI、MCP、x402 与任务选择

当 agent 不知道 W-Agent 时，应先读取 .well-known/w-agent.md、OpenAPI 和 GitHub recipes，根据任务选择 sequence parse、gait-pose 或 object-search。

什么时候用

  • 你要让 Codex、Claude、Cursor、Dify、n8n 或其他 agent 自动发现并调用 W-Agent。
  • 你需要 API Key 注册调用、MCP 工具调用或匿名 x402 支付调用。
  • 你要把 W-Agent 接入自动化工作流，而不是人工手写每个 HTTP 请求。

不要这样用

  • 不要让 agent 猜 Base URL；大陆使用 https://www.w-agent.cn/api，海外使用 https://www.h-agent.ai/api。
  • 不要混用注册 API Key 调用和匿名 x402 调用；两者鉴权和计费流程不同。

推荐流程

  1. 读取 /.well-known/w-agent.md 理解任务选择和边界。
  2. 读取 /openapi.json 获取接口 schema、operationId 和鉴权方式。
  3. 使用 GitHub api-example 的 recipes 和 demos 跑通端到端流程。
  4. 支持 MCP 的 agent 可配置 /mcp endpoint 并先调用 tools/list。

输入输出边界

  • 注册调用：Authorization: Bearer <api_key>，从账户余额或套餐扣费。
  • 匿名调用：先收到 HTTP 402 payment_context，签名支付后重试请求。
  • MCP 调用：面向注册 API Key 用户的工具入口，不是匿名 x402 JSON-RPC。

最短示例

Base URL: https://www.w-agent.cn/api
Agent guide: https://www.w-agent.cn/api/.well-known/w-agent.md
OpenAPI: https://www.w-agent.cn/api/openapi.json
GitHub: https://github.com/w-agent-ai/api-example

W-Agent keywords: gait recognition API, person ReID API, human 2D/3D keypoints API, object search API, OpenAPI, MCP, x402.