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-motion-control",
  "prompt": "A dancer performs graceful movements in a sunlit studio",
  "reference_images": [
    {
      "url": "https://example.com/character.jpg"
    }
  ],
  "reference_videos": [
    {
      "url": "https://example.com/motion-source.mp4"
    }
  ],
  "resolution": "720P",
  "generate_audio": false,
  "extra_params": {
    "character_orientation": "video"
  }
}
'
{
  "task_id": "task_2042864638838083584",
  "model": "kling/kling-v3-motion-control",
  "created_at": "2026-04-21T07: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-motion-control.

​
prompt
string

The prompt, which may contain both positive and negative descriptions. Up to 2500 characters.

Example:

"A dancer performs graceful movements in a sunlit studio"

​
resolution
enum<string>
default:720P

Output resolution. Defaults to 720P.

Available options:
720P,
1080P
​
reference_images
object[]

Reference image. Only 1 image is supported. The character, background, and other elements in the generated video are driven by this image.

Content requirements:

  • The character proportions should match the motion in the reference video — avoid driving a half-body character with full-body motion;
  • The character must clearly expose the full upper body or full body, including limbs and head, without occlusion;
  • Avoid extreme orientations (e.g. inverted, lying flat); the character should occupy a reasonable portion of the frame;
  • Both realistic and stylized characters are supported (humans / humanoid animals / some pure animals / some characters with humanoid limb proportions).

Image requirements:

  • Formats: jpg / jpeg / png;
  • Size ≤ 10 MB;
  • Dimensions: 300px – 65536px;
  • Aspect ratio between 1:2.5 and 2.5:1.
Maximum array length: 1
​
reference_videos
object[]

Reference video. Only 1 clip is supported. The character's motion in the generated video will match this video.

Content requirements:

  • The character must clearly expose the full upper body or full body, including limbs and head, without occlusion;
  • We recommend a single-person video; if multiple people appear, the character occupying the largest portion of the frame is used;
  • Real-person motion is preferred; some stylized characters with humanoid limb proportions are also supported;
  • The video should be a single continuous shot with the character visible throughout — avoid cuts or camera moves (otherwise the clip will be cropped);
  • Avoid overly fast motion; steadier motion produces better results.

Video requirements:

  • Formats: MP4 / MOV;
  • Size ≤ 100 MB;
  • Dimensions (both width and height must fall within): 340px – 3850px;
  • Duration ≥ 3s; the upper bound depends on extra_params.character_orientation:
    • video: ≤ 30s;
    • image: ≤ 10s.
  • Publicly accessible URL only; base64 is not supported.

For high-difficulty or fast motion, the model may only extract a usable subset of the motion (a minimum of 3s of continuous usable motion is required). The generated result may be shorter than the uploaded clip.

Maximum array length: 1
​
generate_audio
boolean
default:false

Whether to generate audio. Defaults to false.

​
extra_params
object

Extension parameters.

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-motion-control"

​
created_at
string

Task creation time (ISO 8601)

Example:

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

​
request_id
string

Unique request ID

Example:

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