Skip to main content
POST
/
kling-video-o1
/
async
curl --request POST \ --url https://api.modellix.ai/api/v1/kling/kling-video-o1/async \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "prompt": "Restyle the source video into a clay-animation look while preserving the original motion feel" } '
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-v2v-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-v2v-abc123"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Conditional rules: when multi_shot=false, prompt is required and shot_type must be omitted. When multi_shot=true, shot_type must be intelligence and prompt is still required. When videos is provided, sound must be off and duration must be omitted. In current production behavior, requests without videos only support duration=5 or duration=10.

​
prompt
string
required

Video generation prompt.

Required string length: 1 - 2500
Example:

"Transform the source clip into a cinematic sci-fi sequence"

​
multi_shot
boolean
default:false

Enable intelligent multi-shot generation.

Example:

false

​
shot_type
enum<string>

Required when multi_shot is true. Only intelligence is supported in the public API.

Available options:
intelligence
Example:

"intelligence"

​
images
string[]

Optional reference image list. In current production behavior, image-guided generation without videos only supports duration=5 or duration=10.

Minimum array length: 1

Reference image URL or Base64 string.

Minimum string length: 1
​
videos
string[]

Optional reference video list. When provided, sound must be off and duration must be omitted.

Required array length: 1 element

Reference video URL or Base64 string.

Minimum string length: 1
​
sound
enum<string>
default:off

Audio generation switch. Must remain off whenever videos is provided.

Available options:
on,
off
Example:

"off"

​
mode
enum<string>
default:pro

Generation mode.

Available options:
std,
pro
Example:

"pro"

​
aspect_ratio
enum<string>

Video aspect ratio.

Available options:
16:9,
9:16,
1:1
Example:

"16:9"

​
duration
enum<integer>
default:5

Video duration in seconds. In current production behavior, omit this field when videos is provided. When using prompt/image-guided generation without videos, only 5 and 10 are supported.

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