對口型任務建立 - CometAPI Documentation

POST

kling

videos

advanced-lip-sync

Create an advanced Kling lip-sync task

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "806556222048190514",
  "face_choose": [
    {
      "face_id": "0",
      "sound_file": "https://cdn1.suno.ai/e5c97078-3260-4354-a3a6-1d7249262a48.mp3",
      "sound_start_time": "1200",
      "sound_end_time": "5000",
      "sound_insert_time": "0"
    }
  ]
}
'

{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

當你已經在來源影片中識別出人臉後，可使用此端點建立進階對口型任務。

呼叫前準備

先使用 Lip-Sync 取得 session_id 與可用的 face_id 值
建立一個或多個 face_choose 項目，將每張臉對應到一段音訊
確認時間相關欄位能描述音訊應如何在影片中對齊

任務流程

先識別人臉

在來源影片上執行 Lip-Sync，並保留回傳的 session_id 以及目標 face_id 值。

建立進階對口型任務

透過此端點提交 session_id 與 face_choose 陣列。

追蹤已產生的任務

保存回傳的 task id，以便進行狀態查詢與取得最終結果。

如需完整的參數參考，請參閱官方 Kling 文件。

授權

Authorization

string

header

必填

Bearer token authentication. Use your CometAPI key.

主體

application/json

session_id

string

預設值:806556222048190514

必填

Session id returned by the face identification (lip-sync) endpoint.

face_choose

object[]

必填

Face-to-audio mappings. Each entry connects a detected face to an audio segment for lip-sync.

Show child attributes

回應

200 - application/json

Task accepted.

code

integer

必填

message

string

必填

data

object

必填

Show child attributes

唇形同步

影片特效

Create an advanced Kling lip-sync task

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "806556222048190514",
  "face_choose": [
    {
      "face_id": "0",
      "sound_file": "https://cdn1.suno.ai/e5c97078-3260-4354-a3a6-1d7249262a48.mp3",
      "sound_start_time": "1200",
      "sound_end_time": "5000",
      "sound_insert_time": "0"
    }
  ]
}
'

{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Documentation Index

​呼叫前準備

​任務流程

授權

主體

回應

呼叫前準備

任務流程