W-Agent

客户端请求

创建一个步态序列解析任务，告诉服务端本次会上传多少帧图片。

POST https://www.w-agent.cn/api/v1/sequences
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "frame_count": 12
}

服务端返回

返回任务 ID 和单个批量上传配置。

{
  "task_id": "seq_xxx",
  "upload": {
    "upload_url": "/v1/sequences/seq_xxx/uploads/batch",
    "upload_token": "upl_xxx",
    "upload_expires_at": "2026-05-06T12:00:00Z",
    "frame_count": 12
  }
}

客户端请求

客户端一次性上传该序列的全部图片。

POST https://www.w-agent.cn/api/v1/sequences/seq_xxx/uploads/batch
Authorization: Bearer <api_key>
Content-Type: multipart/form-data

upload_token=<upload.upload_token from the create response>
frames=<first image file content>
frames=<second image file content>
...

服务端返回

确认本次批量上传的图片已经保存。

{
  "task_id": "seq_xxx",
  "uploaded_count": 12,
  "status": "uploaded"
}

客户端请求

所有图片上传完成后，发起同步解析。

POST https://www.w-agent.cn/api/v1/sequences/seq_xxx/parse
Authorization: Bearer <api_key>
Content-Type: application/json

{}

服务端返回

返回拆分后的单人序列身份识别特征、结构化属性和情绪结果。输入一个序列也会返回数组，是因为跟踪 ID 可能在多人交叉时串到另一个人身上；内部算法会用 ReID 特征检查串框，并在串框位置拆分成多个干净的单人序列。

{
  "task_id": "seq_xxx",
  "status": "succeeded",
  "sequence_count": 2,
  "sequences": [
    {
      "sequence_id": "seq_xxx_split_01",
      "frame_count": 6,
      "frames": [
        {"frame_id": 0, "box": [120, 40, 220, 260]}
      ],
      "gait_feature": [0.12, ...],
      "face_feature": [0.08, ...],
      "reid_feature": [0.31, ...],
      "reid_attributes": [...],
      "emotions": ["neutral"]
    },
    {"sequence_id": "seq_xxx_split_02", "frame_count": 0, "frames": []}
  ]
}

字段说明

• frame_count 序列图片数量，用于计费和校验。
• upload.upload_token 批量上传序列图片时使用的上传令牌。
• sequences 输出序列数组。一个输入序列可能因为跟踪串框被 ReID 检查拆分成多个单人序列。
• sequences[].frames 返回序列对应的帧号和坐标框；输入序列被拆分时，客户端用 frame_id 映射回原始上传帧。
• gait_feature / face_feature / reid_feature 身份识别相关特征向量。
• reid_attributes / emotions 结构化属性和情绪识别结果。

客户端请求

先创建序列任务，告诉服务端本次会上传多少帧单人序列图片。

POST https://www.w-agent.cn/api/v1/sequences
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "frame_count": 12
}

服务端返回

返回任务 ID 和单个批量上传配置。

{
  "task_id": "seq_xxx",
  "upload": {
    "upload_url": "/v1/sequences/seq_xxx/uploads/batch",
    "upload_token": "upl_xxx",
    "upload_expires_at": "2026-05-06T12:00:00Z",
    "frame_count": 12
  }
}

客户端请求

再把该序列的全部图片一次性批量上传。服务端按 frames 出现顺序映射帧序号，不依赖文件名。

POST https://www.w-agent.cn/api/v1/sequences/seq_xxx/uploads/batch
Authorization: Bearer <api_key>
Content-Type: multipart/form-data

upload_token=<upload.upload_token from the create response>
frames=<first image file content>
frames=<second image file content>
...

服务端返回

确认本次批量上传的图片已经保存。

{
  "task_id": "seq_xxx",
  "uploaded_count": 12,
  "status": "uploaded"
}

客户端请求

上传完成后，使用同一个 task_id 调用人体2D/3D关节点接口，按序列个数独立计费。

POST https://www.w-agent.cn/api/v1/sequences/seq_xxx/gait-pose
Authorization: Bearer <api_key>
Content-Type: application/json

{}

服务端返回

返回该序列的 2D/3D 人体关节点和本次人体2D/3D关节点计费信息。

{
  "task_id": "seq_xxx",
  "status": "succeeded",
  "result": {
    "sequence_id": "seq_xxx",
    "frame_count": 12,
    "frames": [...],
    "pose_2ds": [
      [x0, y0, score0, ..., x16, y16, score16]
    ],
    "pose_3ds": [
      [x0, y0, z0, ..., x16, y16, z16]
    ],
    "emotions": [],
    "billing": {
      "amount": "1",
      "currency": "USD",
      "pricing_basis": {
        "rate_per_sequence": 1
      }
    }
  }
}

字段说明

• pose_2ds 外层按帧排列；每帧是 3*17 个浮点数，顺序为 x0,y0,score0...x16,y16,score16。坐标相对上传序列图片，原点为图片中心。
• pose_3ds 外层按帧排列；每帧是 3*17 个浮点数，顺序为 x0,y0,z0...x16,y16,z16。坐标原点为中心。
• billing 本次人体2D/3D关节点独立计费信息。

客户端请求

上传一张已经检测、裁剪并矫正好的人脸图片，接口返回 512 维人脸特征。

POST https://www.w-agent.cn/api/v1/features/face
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "image_base64": "..."
}

服务端返回

返回 feature 数组和本次按单张图片计费的信息；免注册试用可调用 /v1/public/features/trial/face。

{
  "feature": [0.12, 0.08, ...],
  "dimension": 512,
  "billing": {
    "amount": 1,
    "currency": "CNY",
    "order_id": "face_xxx"
  }
}

字段说明

• image_base64 已经矫正的人脸图片 Base64，不带 data:image/... 前缀。
• feature 512 维人脸特征向量；同类型特征可用点积计算相似度。

客户端请求

上传一张单个人体图片，接口返回 512 维 ReID 特征。

POST https://www.w-agent.cn/api/v1/features/reid
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "image_base64": "..."
}

服务端返回

返回 feature 数组和本次按单张图片计费的信息；免注册试用可调用 /v1/public/features/trial/reid。

{
  "feature": [0.31, 0.04, ...],
  "dimension": 512,
  "billing": {
    "amount": 1,
    "currency": "CNY",
    "order_id": "reid_xxx"
  }
}

字段说明

• image_base64 单个人体目标图片 Base64，不带 data:image/... 前缀。
• feature 512 维 ReID 特征向量；同类型特征可用点积计算相似度。