Skip to main content
POST
/
v1
/
videos
/
generate
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"
}

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <YOUR_API_KEY> in the request header. Go to the API Keys management page to create and manage API Keys.

Body

application/json
​
model
string
required

Fixed value kling/kling-v3.

​
prompt
string

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 via extra_params.multi_prompt.

Example:

"A cinematic shot of an orange cat stretching slowly under cherry blossoms, warm sunlight"

​
resolution
enum<string>
default:720P

Output resolution. Defaults to 720P.

Available options:
720P,
1080P
​
aspect_ratio
enum<string>
default:16:9

Output aspect ratio. Defaults to 16:9.

Available options:
16:9,
9:16,
1:1
​
duration
integer
default:5

Video duration in seconds. Defaults to 5; range 3 ~ 15.

Required range: 3 <= x <= 15
​
generate_audio
boolean
default:false

Whether to generate audio. Defaults to false.

​
reference_images
object[]

Reference image list. 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 + 1 last_frame
  • Multi-reference image-to-video: N images with asset
​
extra_params
object

Supports Kling's official extension parameters. All optional:

  • multi_shot — toggle multi-shot mode
  • shot_type — shot type
  • multi_prompt — array of per-shot prompts
  • negative_prompt — negative prompt
  • cfg_scale — prompt adherence
  • camera_control — camera movement control

Response

Submitted successfully (asynchronous mode)

​
task_id
string

Unique task ID, used for subsequent polling

Example:

"task_2042864638838083584"

​
model
string

The model ID used for this task

Example:

"kling/kling-v3"

​
created_at
string

Task creation time (ISO 8601)

Example:

"2026-04-11T07:17:39.146Z"

​
request_id
string

Unique request ID

Example:

"291a4117-9df8-4349-aee1-bdf8ffcacb9a"