Create Video by Image

POST

/kling/v1/videos/image2video

Create Video by Image from Kling
Read More: https://docs.qingque.cn/d/home/eZQDvlYrDMyE9lOforCeWA4KP?identityId=1uX4dFq8Jtr#section=h.ytzy2ithm1c4

Request

Body Params application/json

model_name

string

required

Note: The higher the version, the higher the price. The price of v2.0 is 10 times that of v1, and 10 seconds is 20 times the price.
Enumeration value:
kling-v1
kling-v1-5
kling-v1-6

image

string

required

Support Base64 encoding or image URL, support .jpg / .jpeg / .png format, size cannot exceed 10MB, resolution cannot be less than 300*300px, image aspect ratio must be between 1:2.5 ~ 2.5:1

prompt

string

required

Cannot exceed 2500 characters

negative_prompt

string

optional

Cannot exceed 2500 characters

cfg_scale

number

optional

The larger the value, the higher the creative relevance. The value range is: [0,1]

mode

string

required

Enumeration value:
std
pro

camera_control

object

optional

Control the camera movement mode. If not specified, it will be matched intelligently.

type

string

optional

Predefined camera movement types
Enumeration values: "simple", "down_back", "forward_up", "right_turn_forward", "left_turn_forward"
simple: simple camera movement, in this type, you can choose one of the six camera movements in "config"
down_back: the lens is pressed down and back ➡️ down and zoomed out, the config parameter does not need to be filled in for this type
forward_up: the lens moves forward and tilts up ➡️ pushes up, the config parameter does not need to be filled in for this type
right_turn_forward: rotate right first and then move forward ➡️ right rotation push forward, the config parameter does not need to be filled in for this type
left_turn_forward: rotate left first and move forward ➡️ left rotation push forward, the config parameter does not need to be filled in for this type
Enumeration values:
simple
down_back
forward_up
right_turn_forward
left_turn_forward

config

object

optional

Contains six fields to specify the movement or change of the camera in different directions
Required when the camera movement type is specified as simple, and not required when other types are specified
Select 1 from the following 6 parameters, that is, only one parameter can be non-0, and the rest of the parameters are 0

aspect_ratio

string

optional

Enumeration value:
16:9
9:16
1:1

duration

string

required

Set duration

image_tail

string

optional

Supports Base64 encoding or image URL, supports .jpg / .jpeg / .png format, size cannot exceed 10MB, resolution cannot be less than 300*300px

Example

{
    "model_name": "kling-v1",
    "image": "https://p2.a.kwimgs.com/bs2/upload-ylab-stunt/ai_portal/1731125871/6N0QrAnAeU/409-f054fa25c21a.png",
    "prompt": "A 20-year-old girl, with an oval face, delicate features, long black hair, fair skin, and ambient light, wearing a short white skirt, sitting on a bench beside the street, smiling and shaking her hair",
    "mode": "std",
    "aspect_ratio": "1:1",
    "duration": "5"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/kling/v1/videos/image2video' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kling-v1",
    "image": "https://p2.a.kwimgs.com/bs2/upload-ylab-stunt/ai_portal/1731125871/6N0QrAnAeU/409-f054fa25c21a.png",
    "prompt": "A 20-year-old girl, with an oval face, delicate features, long black hair, fair skin, and ambient light, wearing a short white skirt, sitting on a bench beside the street, smiling and shaking her hair",
    "mode": "std",
    "aspect_ratio": "1:1",
    "duration": "5"
}'

Responses

🟢200OK

application/json

Body

code

integer

required

message

string

required

request_id

string

required

data

object

required

task_id

string

required

task_status

string

required

created_at

integer

required

updated_at

integer

required

Example

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "CmYgjmbyMToAAAAAAF6svw",
  "data": {
    "task_id": "CmYgjmbyMToAAAAAAF6svw",
    "task_status": "submitted",
    "created_at": 1727338013674,
    "updated_at": 1727338013674
  }
}

Get Video by Task ID(text2video)

Get Video by Task ID(image2video)