Kling Image 3.0

kling-v3-image

kling-v3-image Kling Image 3.0 kirin_v3_image kling

Kirin V3 image generation interface, supports text-to-image and image-to-image generation.

Эндпоинты

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 # Отменить задачу

Совет

Добавляйте заголовок аутентификации в каждый запрос: Authorization: Bearer YOUR_API_KEY.

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

curl --request 'POST' 'https://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

Text prompt, can include positive and negative descriptions

Max 2500 characters

---

negative_prompt string

Negative text prompt

Max 2500 characters

It is recommended to write negative prompts as negative descriptions in the positive prompt

Note: Image-to-image (when image field is not empty) does not support negative prompts

---

image string

Reference image

Supports Base64 encoded image or image URL (ensure accessibility)

Image format requirements: Format: .jpg, .jpeg, .png File size: max 10MB Dimensions: min 300px for width and height Aspect ratio: between 1:2.5 ~ 2.5:1

Base64 encoding requirements: If using Base64 method, ensure all image data parameters are Base64 encoded. When submitting data, do not add any prefix before the Base64 encoded string, such as data:image/png;base64,. The correct parameter format should be the Base64 encoded string directly

Example:

Correct Base64 encoded parameter:

iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==

Incorrect Base64 encoded parameter (with data: prefix):

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==

Please provide only the Base64 encoded string portion so the system can correctly process and parse your data

---

element_list array

Subject reference list, configured based on subject ID from subject library

To create a subject, refer to: kirin_custom_elements

Quantity limits: The total number of reference subjects and reference images must not exceed 10

Format as key:value pairs:

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

element_id integer

Subject ID from subject library

---

resolution string

Image generation resolution

Options: 1k, 2k

Default: 1k

---

n integer

Number of images to generate

Default: 1

Range: 1 - 9

---

aspect_ratio string

Image aspect ratio (width:height)

Options: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9

Default: 16:9

---

watermark_info array

Whether to generate results with watermarks simultaneously

Defined via the enabled parameter

Custom watermarks are not currently supported

Format as key:value pairs:

"watermark_info": {
  "enabled": boolean
}

enabled boolean

true for generation, false for no generation

---

callback_url string

Callback notification address for this task result. If configured, the server will actively notify when the task status changes

---

external_task_id string

Custom task ID

User-defined task ID, will not overwrite the system-generated task ID when provided, but supports task query via this ID

Please note that uniqueness must be ensured under a single user

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

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

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

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

Проверить статус

Получить результат

Отменить задачу

Обработка ошибок