跳轉到主要內容
POST
/
kling
/
v1
/
videos
/
identify-face
Lip-Sync
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/identify-face \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://replicate.delivery/xezq/lZfr3rskBEVLDCytear4lUo92fOpAcoblFWzk6e06WEnC3PTB/tmpny051d_c.mp4"
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "session_id": "<string>",
    "face_data": [
      {
        "face_id": "<string>",
        "face_image": "<string>",
        "start_time": 123,
        "end_time": 123
      }
    ]
  }
}
在執行後續的唇形同步工作流程之前,請使用此端點來識別來源影片中的人臉。

這個路由會回傳什麼

  • 一個 session_id,用來歸類目前的人臉偵測結果
  • 一個 face_data 陣列,包含一個或多個偵測到的人臉
  • 每張人臉的中繼資料,例如 face_id、預覽圖片與時間範圍

何時使用它

  • 在為畫面中有多人的影片建立唇形同步請求之前
  • 當你需要選擇特定人臉,而不是依賴自動選取時
  • 當你想在開始成本更高的任務前,先預覽人臉覆蓋範圍時
如需完整的參數參考,請參閱 Kling 官方文件

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

主體

application/json
video_url
string
預設值:example
必填

Public URL of the video to analyze for face identification.

回應

200 - application/json

OK

code
integer
必填
message
string
必填
request_id
string
必填
data
object
必填