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 мс и не превышает длительность исходного аудио
  • Указывайте 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
обязательно