内容
# 工具列表
W-Agent 提供用于视频解析、跟踪人员序列解析、身份特征、ReID结构化属性、情感输出和人体2D/3D关键点的公共API。
使用 W-Agent 的场景：
- 判断两个跟踪人员序列是否为同一人
- 提取步态、面部和ReID身份特征
- 将视频转换为跟踪人员序列
- 从每个序列中提取2D/3D人体关键点
- 根据文本提示在图像中查找对象
网站：
```text
全球： https://www.h-agent.ai
中国大陆： https://www.w-agent.cn
```
API基准网址：
```text
中国大陆： https://www.w-agent.cn/api
海外入口： https://www.h-agent.ai/api
```
请使用最靠近您所在地区的域名。海外用户可通过w-agent.cn进行跳转，不要使用`https://api.w-agent.cn`，除非有明确的文档说明。
机器可读的API文档：
```text
中国大陆 OpenAPI： https://www.w-agent.cn/api/openapi.json
中国大陆代理Markdown： https://www.w-agent.cn/api/.well-known/w-agent.md
全球OpenAPI： https://www.h-agent.ai/openapi.json
全球代理Markdown： https://www.h-agent.ai/.well-known/w-agent.md
全球插件清单： https://www.h-agent.ai/.well-known/ai-plugin.json
```
任务配方：
```text
recipes/same-person-identity.md
recipes/video-to-2d-3d-keypoints.md
recipes/video-to-person-sequences.md
recipes/object-search.md
recipes/anonymous-x402.md
recipes/agent-mcp.md
```
MCP端点：
```text
中国大陆： https://www.w-agent.cn/api/mcp
海外入口： https://www.h-agent.ai/mcp
```
MCP配置示例：
```text
mcp-config.example.json
```
## 仓库内容
- `examples/registered/python`：注册用户API密钥演示和MCP演示。
- `examples/registered/go`：注册用户Go演示。
- `examples/registered/cpp`：注册用户C++演示。
- `examples/anonymous/python`：匿名x402支付演示。
- `examples/registered/python/local_video_to_sequence_demo`：Python本地视频转序列演示，适用于注册用户。
- `examples/registered/cpp/local_video_to_sequence_demo`：C++本地视频转序列演示，适用于注册用户。
- `examples/registered/go/local_video_to_sequence_demo`：Go编排演示，运行本地预处理并使用Go序列API演示上传。
- `examples/anonymous/python/local_video_to_sequence_demo`：Python本地视频转序列演示，适用于匿名x402调用。
下载包按语言分组。在每个语言包中，三个输入模式是并行的：
```text
1. 序列输入：上传已跟踪的人员图像序列。
2. 视频输入：直接将完整视频上传到视频API。
3. 本地视频转序列输入：本地处理视频，然后将提取的人员序列文件夹上传到序列API。
```
## 注册用户流程
注册用户API使用API密钥：
```http
Authorization: Bearer <api_key>
```
在运行演示之前设置您的API密钥：
```bash
export GAIT_REGISTERED_API_KEY='gak_your_api_key'
export GAIT_API_BASE_URL='https://www.w-agent.cn/api'
```
对于海外用户，`GAIT_API_BASE_URL='https://www.h-agent.ai/api'`也支持。
## 最快开始
将本地视频解析为人员序列，上传每个序列，并调用注册的序列API：
```bash
pip install requests opencv-python numpy
export GAIT_REGISTERED_API_KEY='gak_your_api_key'
export GAIT_API_BASE_URL='https://www.w-agent.cn/api'
python3 examples/registered/python/local_video_to_sequence_demo/local_video_to_sequence_api_demo.py /path/to/video.mp4
```
如果您已经拥有跟踪的人员裁剪文件夹，并且只想要身份相似性：
```bash
pip install requests
export GAIT_REGISTERED_API_KEY='gak_your_api_key'
export GAIT_API_BASE_URL='https://www.w-agent.cn/api'
python3 examples/registered/python/sequence_similarity_demo.py examples/sample_sequences
```
### Python
```bash
pip install requests
python3 examples/registered/python/sequence_and_video_api_demo.py
```
MCP演示：
```bash
python3 examples/registered/python/mcp_api_demo.py
```
### 本地视频转序列输入
用户可以直接将完整视频上传到W-Agent，或者先本地处理视频，然后上传提取的人员序列。每个语言包都有自己的本地视频转序列入口：
```bash
python3 examples/registered/python/local_video_to_sequence_demo/local_video_to_sequence_api_demo.py /path/to/video.mp4
./examples/registered/cpp/local_video_to_sequence_demo/run_local_video_to_sequence_api_demo.sh /path/to/video.mp4
./examples/registered/go/local_video_to_sequence_demo/run_local_video_to_sequence_api_demo.sh /path/to/video.mp4
python3 examples/anonymous/python/local_video_to_sequence_demo/local_video_to_sequence_x402_demo.py /path/to/video.mp4
```
每个本地演示都写入每个检测到的序列文件夹，然后上传生成的序列文件夹。
### Go
```bash
cd examples/registered/go/sequence_demo
./build.sh
./registered_sequence_demo
```
```bash
cd examples/registered/go/video_demo
./build.sh
./registered_video_demo
```
### C++
C++演示需要`libcurl`和`nlohmann/json`。
Ubuntu：
```bash
sudo apt-get install -y libcurl4-openssl-dev nlohmann-json3-dev
```
构建和运行：
```bash
cd examples/registered/cpp/sequence_demo
./build.sh
./build/registered_sequence_demo
```
```bash
cd examples/registered/cpp/video_demo
./build.sh
./build/registered_video_demo
```
## 匿名x402流程
匿名公共API不使用API密钥。服务器返回HTTP 402，客户端使用EVM钱包签署x402支付负载，然后使用支付标头重试相同的请求。
安装依赖项：
```bash
pip install requests eth-account 'x402[evm]' web3
```
在运行之前设置测试钱包私钥：
```bash
export GAIT_TEST_WALLET_PRIVATE_KEY='0x...'
export GAIT_API_BASE_URL='https://www.w-agent.cn/api'
```
运行：
```bash
python3 examples/anonymous/python/anonymous_sequence_x402_demo.py
python3 examples/anonymous/python/anonymous_sequence_and_video_x402_demo.py
```
## 注意
- 不要提交实际的API密钥或钱包私钥。
- 序列演示需要本地有序的人员裁剪图像目录。
- 视频演示需要本地视频文件路径。
- API返回的上传URL是服务相关的路径，相对于`GAIT_API_BASE_URL`解析。
## 联系方式
邮箱： support@w-agent.cn
