Kling V3 - Image to Video

kling-v3-i2v

Kirin V3 image-to-video generation interface, supports multi-shot video generation and sound synthesis.

Примечание к API

Image Format Requirements

image and image_tail parameters:

Supports Base64 encoded image or image URL (ensure accessibility)

Please note, if you use base64 format, ensure all image data parameters use Base64 encoding format. 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 directly the Base64 encoded string

Example:

Correct Base64 encoded parameter:

iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==

Incorrect Base64 encoded parameter (contains data: prefix):

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

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

Image requirements: Format: .jpg, .jpeg, .png File size: max 10MB Dimensions: min 300px for width and height image parameter: aspect ratio between 1:2.5 ~ 2.5:1 image_tail parameter: no aspect ratio restriction

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/kling-v3-i2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "image": "https://www.gstatic.com/webp/gallery/4.jpg",
  "prompt": "A cinematic drone shot over a misty mountain range at sunrise",
  "negative_prompt": "blurry, low quality, distorted",
  "sound": "on",
  "cfg_scale": 0.5,
  "mode": "std"
}'

image `string` required

Reference image

image_tail `string`

Reference image - end frame control

multi_shot `boolean`

Whether to generate multi-shot video

When this parameter is true, the prompt parameter is invalid

When this parameter is false, the shot_type and multi_prompt parameters are invalid

Default: false

shot_type `string`

Shot type

When multi_shot parameter is true, this parameter is required

Options: customize

prompt `string`

Video generation prompt, can include positive and negative descriptions

Max 2500 characters

When multi_shot parameter is false, this parameter cannot be empty

multi_prompt `array`

Multi-shot information, such as prompts and durations

Define shot sequence and corresponding prompts and durations via index, prompt, duration parameters:

Supports up to 6 shots, minimum 1 shot
Max length of each shot-related content does not exceed 512
Duration of each shot is not greater than the total duration of the current task, and not less than 1
Sum of durations of all shots equals the total duration of the current task

Format as key:value pairs:

"multi_prompt": [
  {
    "index": int,
    "prompt": "string",
    "duration": "5"
  },
  {
    "index": int,
    "prompt": "string",
    "duration": "5"
  }
]

When multi_shot parameter is true and shot_type parameter is customize, this parameter cannot be empty

negative_prompt `string`

Negative text prompt

It is recommended to add negative prompt information directly in the positive prompt through negative sentences

Max 2500 characters

element_list `array`

Subject reference list

Configured based on subject ID from subject library, format as key:value pairs:

To create a subject, refer to: kirin_custom_elements

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

Max 3 reference subjects supported

Subjects are divided into video custom subjects (video role subjects) and image custom subjects (multi-image subjects), with different applicable scopes, please distinguish

sound `string`

Whether to generate sound when generating video

Options: on, off

Default: off

mode `string`

Video generation mode

std: Standard mode (standard), basic mode, generates 720P video, cost-effective pro: Professional mode (high quality), high performance mode, generates 1080P video, better video quality

Options: std, pro

Default: std

duration `string`

Video duration in seconds

Options: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Default: 5

watermark_info `array`

Whether to generate results with watermarks simultaneously

Defined via the enabled parameter, specific format as follows:

"watermark_info": {
  "enabled": boolean // true for generation, false for no generation
}

Custom watermarks are not currently supported

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

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

Kling V3 - Image to Video

Примечание к API

Image Format Requirements

Эндпоинты

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

image string required

image_tail string

multi_shot boolean

shot_type string

prompt string

multi_prompt array

negative_prompt string

element_list array

sound string

mode string

duration string

watermark_info array

callback_url string

external_task_id string