Skip to main content
POST
cURL
Використовуйте цей endpoint, щоб створити розширене завдання lip-sync після того, як ви вже визначили обличчя у вихідному відео.

Перш ніж викликати його

  • Почніть із Lip-Sync, щоб отримати session_id і доступні значення face_id
  • Створіть один або кілька записів face_choose, які зіставляють кожне обличчя з аудіосегментом
  • Використовуйте audio_id для аудіо, створеного попереднім завданням, або sound_file для розміщеного аудіофайлу
  • Надсилайте поля часу в мілісекундах. Наприклад, sound_start_time: "0" і sound_end_time: "2000" вибирають перші 2 секунди.
  • Переконайтеся, що обрізаний аудіосегмент має щонайменше 2000 ms і не перевищує тривалість вихідного аудіо
  • Установлюйте callback_url або external_task_id лише тоді, коли вам потрібна доставка webhook або власний id для відстеження

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

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
обов'язково

Session id returned by identify-face.

face_choose
object[]
обов'язково

One or more face/audio mappings to synthesize.

Minimum array length: 1
callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Відповідь

200 - application/json

Task accepted.

code
integer
обов'язково
message
string
обов'язково
data
object
обов'язково