curl --request POST \
--url https://openapi.imini.ai/imini/router/v1/videos/generate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling/kling-v3",
"resolution": "720P",
"aspect_ratio": "9:16",
"duration": 8,
"generate_audio": true,
"extra_params": {
"multi_shot": true,
"shot_type": "customize",
"multi_prompt": [
{
"index": 1,
"prompt": "Two friends talking under a streetlight at night. Warm glow, casual poses, no dialogue.",
"duration": "2"
},
{
"index": 2,
"prompt": "A runner sprinting through a forest, leaves flying. Low-angle shot, focus on movement.",
"duration": "3"
},
{
"index": 3,
"prompt": "A woman hugging a cat, smiling. Soft sunlight, cozy home setting, emphasize warmth.",
"duration": "3"
}
]
}
}
'{
"task_id": "task_2042864638838083584",
"model": "kling/kling-v3",
"created_at": "2026-04-11T07:17:39.146Z",
"request_id": "291a4117-9df8-4349-aee1-bdf8ffcacb9a"
}{
"error": {
"code": "INVALID_PARAMETER",
"message": "prompt exceeds max length 2500",
"status": 400,
"request_id": "req_abc123"
}
}Kling v3
Kling 3.0 video generation model. Supports text-to-video, image-to-video, first/last-frame interpolation, and multi-reference image-to-video.
curl --request POST \
--url https://openapi.imini.ai/imini/router/v1/videos/generate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling/kling-v3",
"resolution": "720P",
"aspect_ratio": "9:16",
"duration": 8,
"generate_audio": true,
"extra_params": {
"multi_shot": true,
"shot_type": "customize",
"multi_prompt": [
{
"index": 1,
"prompt": "Two friends talking under a streetlight at night. Warm glow, casual poses, no dialogue.",
"duration": "2"
},
{
"index": 2,
"prompt": "A runner sprinting through a forest, leaves flying. Low-angle shot, focus on movement.",
"duration": "3"
},
{
"index": 3,
"prompt": "A woman hugging a cat, smiling. Soft sunlight, cozy home setting, emphasize warmth.",
"duration": "3"
}
]
}
}
'{
"task_id": "task_2042864638838083584",
"model": "kling/kling-v3",
"created_at": "2026-04-11T07:17:39.146Z",
"request_id": "291a4117-9df8-4349-aee1-bdf8ffcacb9a"
}{
"error": {
"code": "INVALID_PARAMETER",
"message": "prompt exceeds max length 2500",
"status": 400,
"request_id": "req_abc123"
}
}Authorizations
Pass Authorization: Bearer <YOUR_API_KEY> in the request header. Go to the API Keys management page to create and manage API Keys.
Body
Fixed value kling/kling-v3.
The prompt. Up to 2500 characters.
May be empty when
extra_params.multi_shot(multi-shot mode) is enabled; in that case, per-shot prompts are provided viaextra_params.multi_prompt.
"A cinematic shot of an orange cat stretching slowly under cherry blossoms, warm sunlight"
Output resolution. Defaults to 720P.
720P, 1080P Output aspect ratio. Defaults to 16:9.
16:9, 9:16, 1:1 Video duration in seconds. Defaults to 5; range 3 ~ 15.
3 <= x <= 15Whether to generate audio. Defaults to false.
Reference image list, up to 4 images. When empty, the task is text-to-video; otherwise the input mode is determined by the reference_type combination:
- Image-to-video: 1 image with
first_frame - First/last-frame interpolation: 1
first_frame+ 1last_frame - Multi-reference image-to-video: up to 4 images with
asset
Image constraints (each image must satisfy):
- Format:
jpg/jpeg/png - File size: ≤ 10 MB
- Dimensions: width and height each ≥ 200 px
- Aspect ratio: 1:2.5 ~ 2.5:1
4Show child attributes
Show child attributes
Kling's official extension parameters. All optional.
Show child attributes
Show child attributes
Response
Submitted successfully (asynchronous mode)
Unique task ID, used for subsequent polling
"task_2042864638838083584"
The model ID used for this task
"kling/kling-v3"
Task creation time (ISO 8601)
"2026-04-11T07:17:39.146Z"
Unique request ID
"291a4117-9df8-4349-aee1-bdf8ffcacb9a"