API reference

text-to-video

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

Body Parametersapplication/json

contents array

[Alternative] Prompt array form, mutually exclusive with top-level prompt. Each item type must be "prompt" (text-to-video does not support first_frame). Gateway extracts contents[].text into top-level prompt then forwards upstream.

items

object object

options object

Task control parameters, all optional.

properties

callback_url string · uri

Upstream callback URL after task completion (must be publicly accessible).

external_task_id string

Caller-defined external task ID for idempotent queries and reconciliation.

watermark_info object

Watermark config defined by upstream, passed through as-is.

prompt string

[Recommended] top-level prompt. max 3072 characters. full-width punctuation(, ; : )auto-converted to half-width by the gateway. Mutually exclusive with contents[]; if both are set, contents[] is ignored.

settings object

Generation params, all optional. Gateway defaults when missing: resolution=720p, aspect_ratio=16:9, duration=5.

properties

aspect_ratio string

Aspect ratio, default 16:9.

duration integer

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

resolution string

Output resolution, default 720p. 1080p bills ~1.25×.

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"text": "A cat running",

5"type": "prompt"

7],

8"settings": {

9"duration": 5,

10"resolution": "720p"

11}

12}

Code Sample cURL

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

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

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

4-d '{

5"contents": [

7"text": "A cat running",

8"type": "prompt"

10],

11"settings": {

12"duration": 5,

13"resolution": "720p"

14}

15}'

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}