同一人判断 API：步态、人脸、ReID 特征相似度

什么时候用

• 你已有两个单人 track 或人体 crop 图片序列，需要判断是否同一人。
• 你需要步态识别、person re-identification、人脸特征或多特征身份相似度。
• 你需要 agent 按固定流程从本地 sequence 文件夹输出 similarity JSON 或 CSV。

不要这样用

• 不要用图像像素相似度、CLIP 图片相似度或 object-search 结果代替身份相似度。
• 不要交叉比较不同类型特征，例如 gait_feature 不应和 reid_feature 做点积。

推荐流程

1. 对每个单人序列调用 POST /v1/sequences 创建上传任务。
2. 按 upload.upload_token 批量上传图片，上传完成后直接调用 parse。
3. 调用 POST /v1/sequences/{task_id}/parse，读取 response.sequences[0] 的身份特征。
4. 用同类型向量点积计算相似度；face_feature 为 null 表示未检测到可用人脸。

输入输出边界

• 输入：同一 track 的有序人体图片序列，推荐为单人 crop。
• 输出：sequences[]，包含 gait_feature、face_feature、reid_feature、reid_attributes、emotions。
• 说明：一个输入 track 可能因串框被 ReID 拆成多个干净 sequence。