Kling Custom Elements

kling-custom-elements Kling Custom Elements создает субъект Kling и возвращает ID субъекта для последующего использования в генерации изображений или видео Kling.

Эндпоинты

POST /v1/queue/kling-custom-elements # Создать задачу

GET /v1/queue/kling-custom-elements/requests/{request_id}/status # Проверить статус

GET /v1/queue/kling-custom-elements/requests/{request_id}/response # Получить результат

PUT /v1/queue/kling-custom-elements/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-custom-elements' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "element_name": "custom_character",
  "element_description": "AI generated character subject",
  "element_frontal_image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
  "element_refer_list": [
    {
      "image_url": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png"
    },
    {
      "image_url": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-4.png"
    }
  ],
  "tag_list": [
    {
      "tag_id": "o_102"
    }
  ]
}'

element_name string required

Название сущности.

Не должен превышать 20 символов

element_description string required

Описание сущности.

Не должен превышать 100 символов

element_frontal_image string required

Фронтальное референсное изображение сущности.

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

Поддерживаемые форматы: .jpg / .jpeg / .png

Размер файла не должен превышать 10MB; размеры изображения должны быть не менее 300px; соотношение сторон должно быть от 1:2.5 до 2.5:1

element_refer_list array required

Список дополнительных референсных изображений сущности.

Можно загрузить несколько референсных изображений сущности с разных ракурсов, чтобы задать ее внешний вид.

Необходимо загрузить минимум 1 и максимум 3 референсных изображения.

"element_refer_list": [
  { "image_url": "image_url_1" },
  { "image_url": "image_url_2" },
  { "image_url": "image_url_3" }
]

image_url string required

URL изображения или Base64.

tag_list array

Настройка тегов для сущности. Одна сущность может иметь несколько тегов.

"tag_list": [
  { "tag_id": "o_101" },
  { "tag_id": "o_102" }
]

tag_id	Название
o_101	Популярный мем
o_102	Персонаж
o_103	Животное
o_104	Реквизит
o_105	Одежда
o_106	Сцена
o_107	Эффект
o_108	Другое

tag_id string required

ID тега.

Варианты: o_101, o_102, o_103, o_104, o_105, o_106, o_107, o_108

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/kling-custom-elements/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-custom-elements/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-custom-elements/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	ID задачи, используемый для всех последующих операций.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции