W-Agent

Person ReID、步态识别、人脸特征 API

W-Agent 的身份识别核心输入是经过检测跟踪形成的人体序列，输出可用于跨摄像头、跨片段的同一人检索和相似度计算。

什么时候用

  • 你需要 gait recognition API、person re-identification API 或 face feature extraction API。
  • 你有视频中的人员 track，需要提取身份特征和结构化属性。
  • 你要把身份特征接入检索、聚类、同一人比对或后续业务系统。

不要这样用

  • 不要把单张全景图直接当作稳定身份序列；推荐先检测跟踪成单人 sequence。
  • 不要把 object-search 当作 ReID 接口，它只负责按文字描述找图中目标框。

推荐流程

  1. 已有 sequence：使用 /v1/sequences -> upload_url -> /v1/sequences/{task_id}/parse。
  2. 已有视频：先用本地 demo 切 sequence，再调用 Sequence API。
  3. 读取 gait_feature、face_feature、reid_feature、reid_attributes 和 emotions。
  4. 按同类型特征点积做相似度或存入向量库。

输入输出边界

  • 输入：单人有序人体序列。
  • 输出：步态、人脸、ReID 特征向量，以及结构化属性和情绪结果。
  • 边界：face_feature 为 null 不是错误，表示该序列没有可用人脸。

最短示例

POST /v1/sequences
POST /v1/sequences/{task_id}/uploads/batch
POST /v1/sequences/{task_id}/parse
read response.sequences[].gait_feature / face_feature / reid_feature

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