Перейти до основного вмісту
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
  }
}
Використовуйте цей endpoint, щоб створити завдання розширеного lip-sync після того, як ви вже визначили обличчя у вихідному відео.

​
Перед викликом

  • Почніть із Lip-Sync, щоб отримати session_id і доступні значення face_id
  • Створіть один або кілька записів face_choose, які зіставляють кожне обличчя з аудіосегментом
  • Переконайтеся, що поля часу описують, як аудіо має бути вирівняне всередині відео

​
Потік завдання

1

Спочатку визначте обличчя

Запустіть Lip-Sync на вихідному відео та збережіть повернений session_id разом із цільовими значеннями face_id.
2

Створіть завдання розширеного lip-sync

Надішліть session_id і масив face_choose через цей endpoint.
3

Відстежуйте згенероване завдання

Збережіть повернений 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
обов'язково