メインコンテンツへスキップ
POST
/
kling
/
v1
/
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 の値を取得します
  • 各顔を音声セグメントに対応付ける 1 つ以上の face_choose エントリを作成します
  • タイミング関連のフィールドが、動画内で音声をどのように同期させるかを正しく表していることを確認します

タスクの流れ

1

最初に顔を特定

ソース動画に対して Lip-Sync を実行し、返された session_id と対象の face_id の値を保持します。
2

高度なリップシンクタスクを作成

このエンドポイント経由で session_idface_choose 配列を送信します。
3

生成されたタスクを追跡

返された 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.

レスポンス

200 - application/json

Task accepted.

code
integer
必須
message
string
必須
data
object
必須