Создание субъекта

POST

/kling/v1/general/advanced-custom-elements

Создаёт пользовательский субъект для последующей генерации видео и связанных возможностей.

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Не более 20 символов.

Не более 100 символов.

Допустимые значения: video_refer, image_refer

• video_refer: субъект по видео; внешность задаётся element_video_list
• image_refer: субъект по нескольким изображениям; внешность задаётся element_image_list
  Область применения субъектов из видео и изображений различается; см. карту возможностей и описание параметров.

object

Задаёт субъект и детали несколькими изображениями.

Включает фронтальный референс и другие ракурсы или крупные планы: минимум одно фронтальное (frontal_image); 1–3 дополнительных, отличных от фронтального (image_url).

Формат key:value:

"element_image_list": {
"frontal_image": "image_url_0",
"refer_images": [{ "image_url": "image_url_1" }, ...]
}

Поддерживаются Base64 или URL изображений (должны быть доступны).

Форматы: .jpg / .jpeg / .png. Макс. 10 МБ, мин. 300 px, соотношение сторон 1:2.5–2.5:1.

Обязателен при reference_type = image_refer.

object

Задаёт субъект и детали по видео.

Можно загружать видео со звуком; при наличии человеческой речи запускается настройка голоса (обучение, библиотека, привязка к субъекту).

Пока поддерживается только реалистичный человеческий образ из видео.

Обязателен при ссылке на видео; не используется при ссылке на изображения.

Формат key:value. Только MP4/MOV. Длительность 3–8 с, 16:9 или 9:16, 1080p. Не более одного файла, до 200 МБ. video_url не пустой.

"element_video_list": {
"refer_videos": [{ "video_url": "video_url_1" }, ...]
}

Субъекты из видео поддерживаются только в kling-video-o3 и новее.

Привязка существующего голоса из библиотеки.

Если пусто, голос не привязывается.

ID получают через API голосов.

Привязка голоса только для субъектов из видео.

object[]

У одного субъекта может быть несколько тегов.

Формат key:value. ID и названия: o_101 мем, o_102 человек, o_103 животное, o_104 реквизит, o_105 костюм, o_106 сцена, o_107 эффект, o_108 прочее

URL обратного вызова при изменении статуса задачи (если задан).

Пользовательский ID задачи. Не заменяет системный ID, но позволяет запрашивать задачу. Должен быть уникален в рамках пользователя.