Kling V1 - Text to Video

kling-v1-t2v

Basic image-to-video generation that adds natural motion to static visuals.

API Notes

kling-v1-t2v only supports camera control (camera_control) when mode is std and duration is 5 seconds

kling-v1-t2v generates videos at 720p resolution with 30fps frame rate for both std and pro modes

Endpoints

POST /v1/queue/kling-v1-t2v # Create task

GET /v1/queue/kling-v1-t2v/requests/{request_id}/status # Check status

GET /v1/queue/kling-v1-t2v/requests/{request_id}/response # Get result

PUT /v1/queue/kling-v1-t2v/requests/{request_id}/cancel # Cancel task

Request parameters

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

prompt string required

Video generation prompt, must be provided and length between 1-2500 characters

duration string

Video duration in seconds

Options: 5, 10

Default: 5

aspect_ratio string

Video aspect ratio (width:height)

Options: 16:9, 9:16, 1:1

Default: 16:9

negative_prompt string

Negative prompt for specifying content you don't want in the generated video, max 2500 characters

cfg_scale number

Freedom of generated video; larger value means less model freedom, stronger correlation with user input prompt

Range: 0 - 1

Default: 0.5

mode string

Video generation mode

std: Standard mode, basic mode, high cost-performance

pro: Expert mode (high quality), high performance mode, better generated video quality

Options: std, pro

Default: std

camera_control object

Parameter for controlling camera movement (if not specified, model will intelligently match based on input text/image)

type string

Predefined camera movement type

simple: Simple camera movement, can choose one of six movements in config

down_back: Camera presses down and moves back → down and zoom out, no config needed

forward_up: Camera moves forward and tilts up → push in and move up, no config needed

right_turn_forward: First rotate right then move forward → right turn push in, no config needed

left_turn_forward: First rotate left and move forward → left turn push in, no config needed

Options: simple, down_back, forward_up, right_turn_forward, left_turn_forward

config object

Contains six fields for specifying camera movement or changes in different directions

Required when type is simple, not needed for other types

Choose one of the following 6 parameters, only one can be non-zero, others must be 0

horizontal number

Horizontal movement, controls camera horizontal movement (translation along x-axis)

Range: -10 - 10, negative moves left, positive moves right

vertical number

Vertical movement, controls camera vertical movement (translation along y-axis)

Range: -10 - 10, negative moves down, positive moves up

pan number

Horizontal pan, controls camera rotation on horizontal plane (rotation around y-axis)

Range: -10 - 10, negative rotates left, positive rotates right

tilt number

Vertical tilt, controls camera rotation on vertical plane (rotation around x-axis)

Range: -10 - 10, negative tilts down, positive tilts up

roll number

Roll movement, controls camera roll (rotation around z-axis)

Range: -10 - 10, negative rotates counter-clockwise, positive rotates clockwise

zoom number

Zoom, controls camera focal length change, affects field of view distance

Range: -10 - 10, negative zooms in (smaller FOV), positive zooms out (larger FOV)

watermark_info array

Whether to generate results with watermark simultaneously

Defined by enabled parameter, specific array 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 task status changes

external_task_id string

Custom task ID

User-defined task ID. Input will not overwrite system-generated task ID, but supports task query through this ID

Please note, must ensure uniqueness under a single user

Response parameters

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/kling-v1-t2v/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/kling-v1-t2v/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/kling-v1-t2v/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