⌘K

Kirin V1.6 Multi Image to Video

kirin_v1_6_multi_i2v

A video generation model that creates videos from multiple reference images combined with text prompts.

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID used for the request

Value: kirin_v1_6_multi_i2v

image_list array required

Reference image list. Supports up to 4 images, each carrying its URL or Base64 string via the image key:

"image_list": [
  { "image": "image_url_or_base64" },
  { "image": "image_url_or_base64" }
]

No cropping is applied on the API side — upload images with the subject already framed as intended
Supports Base64 encoded images or image URLs (must be publicly accessible)
Note: When using Base64, do not add any prefix (e.g. data:image/png;base64,) — pass the raw Base64-encoded string directly
Supported formats: .jpg / .jpeg / .png
File size must not exceed 10MB; image width and height must be at least 300px; aspect ratio between 1:2.5 and 2.5:1

image string required

Image URL or Base64 encoded string

prompt string required

Positive text prompt

Must not exceed 2500 characters

negative_prompt string

Negative text prompt

Must not exceed 2500 characters

mode string

Video generation mode

Default: std

Options: std, pro

std: Standard mode — basic mode with high cost-efficiency
pro: Pro mode (high quality) — high-performance mode with better video quality

duration string

Generated video duration in seconds

Default: 5

Options: 5, 10

aspect_ratio string

Aspect ratio of the generated video (width:height)

Default: 16:9

Options: 16:9, 9:16, 1:1

watermark_info object

Whether to generate a watermarked version of the result. Custom watermarks are not supported.

enabled boolean

true: Generate a watermarked version
false: Do not generate a watermarked version

callback_url string

Callback notification address for this task. If configured, the server will actively notify when the task status changes.

external_task_id string

Custom task ID

A user-defined task ID. It does not override the system-generated task ID but can be used to query the task.

Note: Must be unique per user.

Polling

Since result generation takes time, you need to poll the task status after creating the task.

The initial response only returns information such as the task ID and initial status. The final result must be obtained by polling the task status endpoint using the task ID.

See the examples on the right for polling requests and responses.

Response Format

error object

Error information, only present when status is failed

code string

Error code

message string

Detailed error message

output array

Generation results, only present when status is completed

content array

List of generated resource content

type string

Resource type

Value: image｜video

url string

Processed resource URL

jobId string

Remote task ID

usage object

Usage statistics, only present when status is completed

cost string

Total cost in USD

discount number

Discount amount

metadata object

Metadata information