API reference

Multi-picture reference student video

POST/kling/v1/videos/multi-image2video

Body Parametersapplication/json

aspect_ratio string

Aspect ratio, optional. Gateway validates enum when set; otherwise upstream decides.

callback_url string · uri

Task completion callback URL; must be publicly reachable; gateway pass-through.

cfg_scale number

CFG, optional. Gateway pass-through; range not pre-validated.

duration* oneOf

Video duration (seconds), required. Only 5 or 10; string/integer OK; gateway normalizes to string. If missing, Relay billing: duration must be 5 or 10.

external_task_id string

Caller external task ID for idempotency/reconciliation; not response data.task_id.

image_list* array

Reference images, required, 1–4; each needs image (URL/Base64). Gateway only checks non-empty; format/size by upstream.

items

object object

mode string

generation mode. billing defaults to std if omitted. 4k not supported.

model_name* string

Model name, required. Gateway only allows kling-v1-6; otherwise 400.

negative_prompt string

Negative prompt, optional. Gateway pass-through; length not pre-validated (only prompt has 2500 check).

prompt string

Positive prompt, optional. Gateway does not require it; if set, ≤2500 chars. Recommended to guide motion/style.

Responses

200 application/json

response-200 object

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"aspect_ratio": "16:9",

3"duration": "5",

4"image_list": [

6"image": "{{image_url_1}}"

7},

9"image": "{{image_url_2}}"

10}

11],

12"mode": "std",

13"model_name": "kling-v1-6",

14"prompt": "A cinematic scene blending the subjects from reference images, smooth camera movement"

15}

Code Sample cURL

1curl -X POST "https://api.digislash.com/kling/v1/videos/multi-image2video" \

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

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

4-d '{

5"aspect_ratio": "16:9",

6"duration": "5",

7"image_list": [

9"image": "{{image_url_1}}"

10},

11{

12"image": "{{image_url_2}}"

13}

14],

15"mode": "std",

16"model_name": "kling-v1-6",

17"prompt": "A cinematic scene blending the subjects from reference images, smooth camera movement"

18}'

Response

1▼{

2"code": 0,

3▼"data": {

4"task_id": "task_example_001"

5},

6"message": "success"