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

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

  • Надайте одне аватарне image як публічний URL або рядок raw base64
  • Використовуйте зображення аватара, яке відповідає вимогам Kling щодо пікселів; мініатюрні thumbnail буде відхилено завданням генерації
  • Надішліть рівно одне з audio_id або sound_file
  • Перший запит має бути простим: одне зображення обличчя, один аудіокліп і короткий необов’язковий prompt
  • Додавайте task_id, коли пов’язане аудіо належить попередньому завданню, яке потрібно прив’язати
  • Починайте з mode: std, якщо вам спеціально не потрібен шлях із вищою якістю

Правила для джерела аудіо

  • audio_id — найпростіший варіант, якщо ви вже згенерували мовлення через маршрут Kling TTS
  • sound_file підходить, якщо у вас уже є власний ресурс MP3, WAV, M4A або AAC
  • Для аудіо аватара вказано тривалість від 2 до 60 секунд

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

1

Створіть завдання аватара

Надішліть зображення та одне джерело аудіо, а потім збережіть повернутий id завдання.
2

Опитуйте завдання

Продовжуйте з Отримання завдання Kling, доки завдання не досягне кінцевого стану.
3

Збережіть готовий результат

Скопіюйте фінальний ресурс у власне сховище, якщо вам потрібне зберігання довше, ніж URL доставки від провайдера.
Повний довідник параметрів дивіться в офіційній документації Kling Avatar.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Заголовки

Content-Type
string

Optional content type header.

Тіло

application/json
image
string
обов'язково

Avatar image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected.

prompt
string
обов'язково

Prompt describing the desired avatar performance.

audio_id
string
обов'язково

Audio id from a prior Kling audio task.

sound_file
string

Public audio URL when you provide your own audio.

task_id
string

Optional prior task id associated with the referenced audio asset.

mode
enum<string>

Generation mode. Use std or pro; omitted requests use std.

Доступні опції:
std,
pro

Відповідь

200 - application/json

Task accepted.

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