Skip to main content
POST
Create an image-to-video task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model_name
enum<string>

Model name

Available options:
kling-v1
Example:

"kling-v1"

image
string

Reference image (first frame). Base64 or URL. Format: .jpg/.jpeg/.png, ≤10MB, minimum 300px.

image_tail
string

Reference image (last frame). At least one of image or image_tail is required.

prompt
string

Positive prompt. Required when multi_shot is false.

Maximum string length: 2500
negative_prompt
string

Negative prompt.

Maximum string length: 2500
mode
enum<string>
default:std

std: standard mode. pro: professional mode (higher quality).

Available options:
std,
pro
duration
enum<string>
default:5

Video duration in seconds, 3-15.

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
cfg_scale
number
default:0.5

Prompt adherence (0-1). Higher values stay closer to the prompt.

Required range: 0 <= x <= 1
multi_shot
boolean
default:false

Whether to enable multi-shot storyboarding.

shot_type
enum<string>

Storyboard mode.

Available options:
customize,
intelligence
multi_prompt
object[]

Storyboard shots (1-6).

element_list
object[]

Reference elements (up to 3).

sound
enum<string>
default:off

Whether to generate sound effects. V2.6+ only.

Available options:
on,
off
camera_control
object

Camera movement control.

static_mask
string

Static brush mask (Base64 or URL).

dynamic_masks
object[]

Dynamic brush configuration (up to 6 groups).

watermark_info
object
callback_url
string
external_task_id
string

Response

Task created successfully

id
string
Example:

"860260753860210752"

task_id
string
Example:

"860260753860210752"

object
string
Example:

"video"

model
string
Example:

"kling-v1"

status
string
progress
integer
Example:

0

created_at
integer
Example:

1773130665