API reference

image-to-video

POST/kling/image-to-video/kling-3.0-turbo

Body Parametersapplication/json

contents* array

Content array, required. Rules: (1) ≥1 type=first_frame with url; (2) optional type=prompt (text ≤2500); (3) type only prompt/first_frame else 400.

items

schema oneOf

options object

Task control parameters, all optional.

properties

callback_url string · uri

Upstream callback URL after task completion.

external_task_id string

Caller-defined external task ID for idempotent queries.

watermark_info object

Watermark config, passed through as-is.

settings object

Generation params, all optional. Warning: I2V body pass-through; missing settings are not defaulted—set explicitly.

properties

aspect_ratio string

Aspect ratio. Warning: officially I2V follows first-frame aspect so upstream ignores this; gateway still uses it for billing—match first frame or omit.

duration integer

Video duration (seconds), range 3–15. Billing scales linearly with duration.

resolution string

Output resolution. 1080p bills ~1.5×.

Responses

200 application/json

response-200 object

properties

code* integer

0 = success; non-zero = failure; see message

data* object

Task info. id and task_id may both carry the task ID; prefer id.

message* string

Message text

request_id string

upstream request ID; provide to upstream support when troubleshooting

400 Bad request or validation failed application/json

response-400 object

properties

error* object

401 Missing or invalid API Key application/json

response-401 object

Request Body Example 1

2"contents": [

4"type": "first_frame",

5"url": "https://example.com/first-frame.jpg"

7],

8"settings": {

9"aspect_ratio": "16:9",

10"duration": 5,

11"resolution": "720p"

12}

13}

Code Sample cURL

1curl -X POST "https://api.digislash.com/kling/image-to-video/kling-3.0-turbo" \

2-H "Authorization: Bearer <API Key>" \

3-H "Content-Type: application/json" \

4-d '{

5"contents": [

7"type": "first_frame",

8"url": "https://example.com/first-frame.jpg"

10],

11"settings": {

12"aspect_ratio": "16:9",

13"duration": 5,

14"resolution": "720p"

15}

16}'

Response

1▼{

2"code": 0,

3▼"data": {

4"id": "string",

5"status": "string",

6"task_id": "string",

7"task_status": "string"

8},

9"message": "string"

10}