Kirin V2.5 Turbo - Image to Video

API Notes

kirin_v2_5_turbo_i2v does not support tail frame only.

kirin_v2_5_turbo_i2v only supports both image and image_tail parameters when mode is pro.

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 to use for the request.

Value: kirin_v2_5_turbo_i2v

---

image string required

Reference image

Supports Base64 encoded image or image URL (ensure accessible)

Please note, if you use Base64, ensure all image data parameters use Base64 encoding format. Do not add any prefix such as data:image/png;base64, before the Base64 string. The correct format should be the Base64 encoded string directly

Image requirements:
Format: .jpg, .jpeg, .png
File size: Less than 10MB
Dimensions: Width and height at least 300px, aspect ratio between 1:2.5 and 2.5:1

image parameter and image_tail parameter must have at least one, both cannot be empty at the same time

---

prompt string

Video generation prompt, maximum 2500 characters

---

negative_prompt string

Negative text prompt, maximum 2500 characters

---

duration string

Video duration in seconds

Options: 5, 10

Default: 5

---

mode string

Video generation mode

std: Standard mode, basic mode with high cost-effectiveness
pro: Expert mode (high quality), high performance mode with better video quality

Options: std, pro

Default: std

---

image_tail string

Reference image - tail frame control

Supports Base64 encoded image or image URL (ensure accessible)

Please note, if you use Base64, ensure all image data parameters use Base64 encoding format. Do not add any prefix such as data:image/png;base64, before the Base64 string. The correct format should be the Base64 encoded string directly

Image requirements:
Format: .jpg, .jpeg, .png
File size: Less than 10MB
Dimensions: Width and height at least 300px

image parameter and image_tail parameter must have at least one, both cannot be empty at the same time

---

watermark_info string

Whether to generate results with watermarks simultaneously

Defined via the enabled parameter, specific format as follows:

"watermark_info": {
  "enabled": boolean // true for generation, false for no generation
}

Custom watermarks are not currently supported

---

callback_url string

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

---

external_task_id string

Custom task ID

User-defined task ID, will not overwrite the system-generated task ID when provided, but supports task query via this ID

Please note that uniqueness must be ensured under a single user

---

Polling

Since video generation takes time, you need to poll the task status after creation

The initial response returns the task ID and initial status. The actual generation results must be obtained through polling the task status endpoint

Response Format

error object

Error information. Only present when status is failed.

code string

Error code

error_message string

Detailed error message

---

output array

Generation results. Only present when status is completed.

content array

List of generated content

type string

Resource type, e.g., video, image

url string

Generated content URL

size string

Image size

---

usage object

Usage statistics. Only present when status is completed.

cost string

Total cost in USD

discount number

Discount amount

---

metadata object

Metadata information

---

Error Codes

Error Code	Description
002012095	Internal generation error
002012096	Result parsing error
002012097	HTTP error response
002012098	Status check error
002012099	Task creation error