Skip to main content
POST
/
kling-v1-i2v
/
async
curl --request POST \
  --url https://api.modellix.ai/api/v1/image-to-video/kling/kling-v1-i2v/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "https://example.com/mountain.jpg"
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-i2v001",
    "model_id": "kling-v1-i2v"
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json
​
image
string
required

Starting frame image URL or Base64 (at least one of image or image_tail required)

Example:

"https://example.com/image.jpg"

​
image_tail
string

Ending frame image URL or Base64 (mutually exclusive with motion brush and camera control)

Example:

"https://example.com/end.jpg"

​
prompt
string

Video generation prompt, supports Chinese and English

Required string length: 1 - 2500
Example:

"Camera slowly zooms in on the mountain landscape"

​
negative_prompt
string

Negative prompt describing undesired elements

Required string length: 1 - 2500
Example:

"blurry, low quality, static"

​
cfg_scale
number
default:0.5

Prompt relevance (0.0-1.0). Only supported by V1 and V1.6.

Required range: 0 <= x <= 1
Example:

0.6

​
mode
enum<string>
default:std

Generation mode: std (standard, faster) or pro (professional, higher quality but longer processing)

Available options:
std,
pro
Example:

"std"

​
static_mask
string

Static mask image URL or Base64 for motion brush (mutually exclusive with image_tail and camera_control)

Example:

"https://example.com/mask.jpg"

​
dynamic_masks
object[]

Dynamic mask array for motion brush (mutually exclusive with image_tail and camera_control)

​
duration
enum<integer>
default:5

Video duration in seconds

Available options:
5,
10
Example:

5

Response

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required