Kling Image 2.1

kling-v2-1-image Kling V2.1 Image поддерживает text-to-image и image-to-image с улучшенным контролем субъекта, сцены и стиля.

Эндпоинты

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

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

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

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

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

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

prompt string required

Текстовый промпт, описывающий изображение для генерации.

Максимальная длина: 2500 символов.

image string

Референсное изображение. Передайте это поле, если нужно сгенерировать изображение на основе входного изображения. Не передавайте его для генерации по тексту.

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

Требования к изображению:

Форматы изображений: .jpg, .jpeg, .png.

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

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

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

image_reference string

Тип референса изображения для референса персонажа или лица.

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

face: референс особенностей лица

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

negative_prompt string

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

Максимальная длина: 2500 символов.

В запросах генерации по изображению, где передан параметр image, негативные промпты могут не поддерживаться.

n integer

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

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

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

resolution string

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

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

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

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:

"watermark_info": {
  "enabled": boolean
}

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

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

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

callback_url string

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

external_task_id string

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

Значение должно быть уникальным для каждого пользователя.

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

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

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