Create a Kling image-to-video task

Generate a video from an image using a Kling model. Pass the image through the image parameter as an image URL or Base64-encoded image data.

POST /kling/v1/videos/image2video

Service root: https://getrouter.ai

Protocol: Provider task API

Authentication: Authorization: Bearer YOUR_API_KEY

Request body

The request body is optional. Media type: application/json

Request fields

Field	Type	Required	Description
`model`	`string`	No	Model or style ID
`prompt`	`string`	No	Text prompt describing the video
`image`	`string`	No	Image input (URL or Base64)
`duration`	`number`	No	Video duration in seconds
`width`	`integer`	No	Video width
`height`	`integer`	No	Video height
`fps`	`integer`	No	Video frame rate
`seed`	`integer`	No	Random seed
`n`	`integer`	No	Number of videos to generate
`response_format`	`string`	No	Response format
`user`	`string`	No	User identifier
`metadata`	`object`	No	Additional parameters, such as negative_prompt, style, and quality_level

Example request

curl --request POST \
  --url https://getrouter.ai/kling/v1/videos/image2video \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

Responses

Status	Description
`200`	Video generation task created successfully
`400`	Invalid request parameters

Success response fields

Field	Type	Required	Description
`task_id`	`string`	No	Task ID
`status`	`string`	No	Task status

Example response

{
  "task_id": "TASK_ID",
  "status": "completed"
}

For complete workflows and examples, read the Video Generation API Guide.

This page is generated from the public Relay OpenAPI specification. Browse the complete specification in the API Explorer.

#Create a Kling image-to-video task

#Request body

#Request fields

#Example request

#Responses

#Success response fields

#Example response

#Related guide