Kling V2.6 - Image to Video

kling-v2-6-i2v

Advanced image-to-video generation with voice synthesis support and enhanced motion control.

API Notes

kling-v2-6-i2v only supports video with sound when mode is pro and sound is on.

kling-v2-6-i2v only supports both image and image_tail parameters when mode is pro.

kling-v2-6-i2v generates silent video when both image and image_tail parameters are used (first and last frame mode).

Endpoints

POST /v1/queue/kling-v2-6-i2v # Create task

GET /v1/queue/kling-v2-6-i2v/requests/{request_id}/status # Check status

GET /v1/queue/kling-v2-6-i2v/requests/{request_id}/response # Get result

PUT /v1/queue/kling-v2-6-i2v/requests/{request_id}/cancel # Cancel task

Request parameters

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/kling-v2-6-i2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "image": "https://www.gstatic.com/webp/gallery/2.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": "pro"
}'

image string required

Reference image

Supports Base64 encoded image or image URL (ensure accessible)

Please note, if you use Base64, ensure all image data parameters use Base64 encoding format. Do not add any prefix such as data:image/png;base64, before the Base64 string. The correct format should be the Base64 encoded string directly

Image requirements:

Format: .jpg, .jpeg, .png

File size: Less than 10MB

Dimensions: Width and height at least 300px, aspect ratio between 1:2.5 and 2.5:1

image_tail string

Reference image - tail frame control

Supports Base64 encoded image or image URL (ensure accessible)

Image requirements:

Format: .jpg, .jpeg, .png

File size: Less than 10MB

Dimensions: Width and height at least 300px, aspect ratio between 1:2.5 and 2.5:1

Note: Only supported when mode is pro for first and last frame mode, and videos generated with first and last frame are silent

prompt string

Positive text prompt, maximum 2500 characters

Use <<<voice_1>>> to specify voice timbre, the number corresponds to the order of voices referenced in the voice_list parameter

A video generation task can reference at most 2 voice timbres. When specifying voice timbre, the sound parameter value must be on

The simpler the syntax structure, the better. For example: Man <<<voice_1>>> says: "Hello"

negative_prompt string

Negative text prompt, maximum 2500 characters

mode string

Video generation mode

std: Standard mode with high cost-effectiveness

pro: Professional mode, takes longer to generate videos but produces higher quality output

Options: std, pro

Default: std

sound string

Whether to generate sound simultaneously when generating video

Note: Only supported when mode is pro

Options: on, off

Default: off

voice_list array

List of voice timbres referenced when generating video

A video generation task can reference at most 2 voice timbres

When voice_list parameter is not empty and voice ID is referenced in the prompt parameter, the video generation task will be metered and billed as "with specified voice timbre"

duration string

Video duration in seconds

Options: 5, 10

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

Response parameters

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

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling