对口型人脸识别

对口型（`kling-lip-sync`）第一步：识别素材中的人脸，得到 session ID 与人脸 ID。

POST/v1/kling/faces

同步接口，按次计费。识别结果含会话 ID 与人脸 ID，有效期 24 小时；第二步把它们填进提交视频任务的 extra.session_id 与 extra.face_choose（恰好一项，含 face_id 与 sound_file），流程见对口型。

请求体只接受 videos 数组，每项 url / file_id 二选一，规则同素材定位。

对口型人脸识别

curl https://api.hop-base.com/v1/kling/faces \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "file_id": "source-video-file-id"
      }
    ]
  }'

200application/json

返回 JSON，含会话 ID 与人脸 ID，24 小时内有效。

请求头

Authorization:必填string

Bearer sk-…：控制台「API 密钥」里创建的密钥，所属分组须包含请求的模型

请求体参数JSON

videos:必填array of object

要识别人脸的素材，至少一项

数量≥ 1 项

200识别结果 JSON，含会话 ID 与人脸 ID（24 小时有效）

application/json 人脸识别结果

错误

400请求不合规，不计费。原文： request body does not match the JSON contract: …：JSON 不合法、带了表外字段或请求体后面还有第二个 JSON 值 videos is required and must contain at least one item videos[<序号>] must provide exactly one of url or file_id videos[<序号>].url must be a publicly accessible absolute http(s) URL

401没带密钥、密钥无效或已过期（missing_api_key / invalid_api_key / api_key_expired）

请求头

请求体参数JSON

返回

错误

相关页面