Kling Image 3.0

kling-v3-image Kling Image 3.0 повышает согласованность, поддерживает гибкую работу с несколькими референсными изображениями и обеспечивает комплексное повышение производительности.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-image' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A beautiful sunset landscape painting in impressionist style",
  "negative_prompt": "",
  "resolution": "1k",
  "n": 1,
  "aspect_ratio": "16:9"
}'

prompt string required

Положительный текстовый промпт

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

negative_prompt string

Негативный текстовый промпт

Максимум 2500 символов

Рекомендуется указывать негативные требования как негативные описания в положительном промпте

Примечание: Image-to-image (когда поле image не пустое) не поддерживает негативные промпты

image string

Референсное изображение

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

Требования к формату изображения:

Формат: .jpg, .jpeg, .png

Размер файла: не более 10MB

Размеры: ширина и высота не менее 300px

Соотношение сторон: от 1:2.5 до 2.5:1

Требования к Base64:

При использовании Base64 убедитесь, что все параметры с данными изображения передаются в формате Base64. Не добавляйте перед строкой Base64 префиксы, например data:image/png;base64,; передавайте только саму Base64-строку

Обязателен, если параметр image_reference не пустой

image_reference string

Тип референса изображения

Варианты: subject, face

subject: референс характеристик персонажа

face: референс внешности лица человека

При использовании face загруженное изображение должно содержать ровно 1 лицо

element_list array

Список референсных субъектов, настроенный по ID субъекта из библиотеки субъектов

Создание субъекта описано здесь: kling_custom_elements

Ограничения по количеству:

Общее количество референсных субъектов и референсных изображений не должно превышать 10

Формат key:value:

"element_list": [
  {
    "element_id": long
  },
  {
    "element_id": long
  }
]

element_id long

ID субъекта из библиотеки субъектов

resolution string

Разрешение генерации изображения

Варианты: 1k, 2k

По умолчанию: 1k

n integer

Количество изображений для генерации

По умолчанию: 1

Диапазон: 1 - 9

aspect_ratio string

Соотношение сторон изображения (ширина:высота)

Варианты: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9

По умолчанию: 16:9

watermark_info object

Генерировать ли одновременно результат с водяным знаком

Задается параметром enabled

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

Формат key:value:

"watermark_info": {
  "enabled": boolean
}

enabled boolean

true: генерировать, false: не генерировать

callback_url string

Адрес обратного вызова для уведомлений о результате этой задачи. Если он задан, сервер будет отправлять уведомления при изменении статуса задачи

external_task_id string

Пользовательский ID задачи

Пользовательский ID задачи. Он не перезаписывает системный ID, но позволяет искать задачу по этому ID

Убедитесь, что значение уникально в рамках одного пользователя

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-image/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-image/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-image/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	Текущая позиция в очереди.

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