POST /v1/sequences
{
  "frame_count": 12
}

{
  "task_id": "seq_xxx",
  "uploads": [
    {"index": 0, "url": "/v1/sequences/seq_xxx/frames/0"},
    ...
  ]
}

PUT /v1/sequences/seq_xxx/frames/0
Content-Type: image/jpeg

<binary image bytes>

{
  "uploaded": true
}

POST /v1/sequences/seq_xxx/parse
{
  "frame_count": 12
}

{
  "status": "succeeded",
  "result": {
    "sequence_id": "seq_xxx",
    "frame_count": 12,
    "gait_feature": [0.12, ...],
    "face_feature": [0.08, ...],
    "reid_feature": [0.31, ...],
    "reid_struct": {...},
    "pose_2ds": [...],
    "pose_3ds": [...],
    "emotion": "neutral"
  }
}

人体2D/3D关节点示例

客户端请求

使用已上传的序列图片，单独调用人体2D/3D关节点接口，按序列帧数独立计费。

POST /v1/sequences/seq_xxx/gait-pose
{
  "frames": [
    {"index": 0, "object_key": "sequences/seq_xxx/000000.jpg"},
    {"index": 1, "object_key": "sequences/seq_xxx/000001.jpg"},
    ...
  ]
}

服务端返回

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

{
  "task_id": "seq_xxx",
  "status": "succeeded",
  "result": {
    "sequence_id": "seq_xxx",
    "frame_count": 12,
    "frames": [...],
    "pose_2ds": [...],
    "pose_3ds": [...],
    "emotions": [],
    "billing": {
      "amount": "1",
      "currency": "USD",
      "pricing_basis": {
        "rate_per_k_frames": 10
      }
    }
  }
}

字段说明

• pose_2ds 每帧 17 个 2D 关节点，每个点为 score、x、y。
• pose_3ds 每帧 17 个 3D 关节点，每个点为 x、y、z。
• billing 本次人体2D/3D关节点独立计费信息。

解析视频示例

客户端请求

创建一个视频解析任务，告诉服务端视频文件名。

POST /v1/videos
{
  "filename": "demo.mp4"
}

服务端返回

返回任务 ID 和视频文件上传地址。

{
  "task_id": "vid_xxx",
  "upload_url": "/v1/videos/vid_xxx/content"
}

客户端请求

客户端把完整视频文件上传到 upload_url。

PUT /v1/videos/vid_xxx/content
Content-Type: video/mp4

<binary video bytes>

服务端返回

确认视频已经上传成功，并返回检测到的视频帧数。

{
  "uploaded": true,
  "frame_count": 2992
}

客户端请求

上传完成后启动异步视频解析。

POST /v1/videos/vid_xxx/start

服务端返回

返回当前任务状态，表示视频已经进入处理队列。

{
  "status": "processing"
}

客户端请求

轮询任务状态，直到处理完成或失败。

GET /v1/videos/vid_xxx

服务端返回

返回当前任务状态；succeeded 表示可以获取最终结果。

{
  "status": "succeeded"
}

客户端请求

处理完成后获取完整解析结果。

GET /v1/videos/vid_xxx/result

服务端返回

返回视频中的人员序列，每个序列包含帧位置、身份识别特征、结构化属性、姿态和情绪结果。

{
  "status": "succeeded",
  "video": {
    "frame_count": 2992
  },
  "sequences": [
    {
      "sequence_id": "trk_001",
      "frames": [
        {"frame_id": 1, "rect": {"x": 10, "y": 20, "width": 80, "height": 180}}
      ],
      "gait_feature": [0.12, ...],
      "face_feature": [0.08, ...],
      "reid_feature": [0.31, ...],
      "reid_struct": {...},
      "pose_2ds": [...],
      "pose_3ds": [...],
      "emotion": "neutral"
    }
  ]
}

字段说明

• filename 视频文件名，用于创建视频任务。
• upload_url 视频文件上传地址。
• sequences[] 视频中的人员序列，包含帧号、坐标框和序列结果。
• rect OpenCV Rect，表示左上角坐标和宽高。
• status 任务状态，例如等待上传、处理中、成功或失败。