Kling Image 3.0 Omni

kling-v3-omni-image Kling Image 3.0 Omni усиливает повествовательную глубину, выводит нативные 2K/4K Ultra HD изображения и поддерживает генерацию серий изображений.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-omni-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_list": [
    {
      "image": "https://www.gstatic.com/webp/gallery/2.jpg"
    }
  ],
  "resolution": "1k",
  "n": 1,
  "aspect_ratio": "1:1"
}'

prompt string required

Текстовый промпт. Может включать положительные и отрицательные описания, а также использовать шаблоны промптов для разных сценариев генерации изображений. Максимум 2500 символов

Модель Image O3 может выполнять разные задачи с помощью промпта, изображений и другого контента. Используйте формат <<<>>>, чтобы указать конкретное изображение, например <<<image_1>>>

image_list array

Список референсных изображений

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

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

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

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

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

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

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

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

Значение параметра image не должно быть пустым

Формат key:value:

"image_list": [
  {
    "image": "image_url"
  },
  {
    "image": "image_url"
  }
]

image string required

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

element_list array

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

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

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

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

Формат key:value:

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

element_id long

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

resolution string

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

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

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

result_type string

Переключатель генерации одиночного изображения или серии изображений

Варианты: single, series

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

n integer

Количество генерируемых изображений

Диапазон от 1 до 9

Если параметр result_type имеет значение series, этот параметр не используется

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

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

series_amount integer

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

Если параметр result_type имеет значение single, этот параметр не используется

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

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

aspect_ratio string

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

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

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

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

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