對口型人臉辨識

對口型（`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

回傳

錯誤

相關頁面