人脸数据管理

基础信息

• Base URL: https://stardust.ticos.cn
• 认证: Authorization: Bearer <token>

端点总览

• POST /faces：新增人脸
• GET /faces：获取人脸列表
• POST /faces/{face_id}：按 face_id 新增/覆盖
• GET /faces/{face_id}：获取人脸详情
• PUT /faces/{face_id}：更新人脸信息
• DELETE /faces/{face_id}：删除人脸

请求字段

• face_id：人脸唯一标识
• name：名称
• image_base64：Base64 图像（如 data:image/jpeg;base64,...）

示例：新增人脸

curl --location 'https://stardust.ticos.cn/faces' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data '{
  "face_id": "1",
  "name": "william",
  "image_base64": "data:image/jpeg;base64,XXXXXX"
}'

示例：查询列表

curl --location 'https://stardust.ticos.cn/faces' \
--header 'Authorization: Bearer <API_KEY>'

示例：更新名称

curl --location --request PUT 'https://stardust.ticos.cn/faces/1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data '{"name":"huyiyang"}'

示例：删除

curl --location --request DELETE 'https://stardust.ticos.cn/faces/1' \
--header 'Authorization: Bearer <API_KEY>'

常见状态码

• 200 OK：成功
• 400 Bad Request：参数错误或 JSON 格式错误
• 401 Unauthorized：鉴权失败