Kirin V1 - Text to Video

API Notes

kirin_v1_t2v only supports camera control (camera_control) when mode is std and duration is 5 seconds

kirin_v1_t2v generates videos at 720p resolution with 30fps frame rate for both std and pro modes

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_v1_t2v

---

prompt string required

Video generation prompt, must be provided and length between 1-2500 characters

---

duration string

Video duration in seconds

Options: 5, 10

Default: 5

---

aspect_ratio string

Video aspect ratio (width:height)

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

Default: 16:9

---

negative_prompt string

Negative prompt for specifying content you don’t want in the generated video, max 2500 characters

---

cfg_scale number

Freedom of generated video; larger value means less model freedom, stronger correlation with user input prompt

Range: 0 - 1

Default: 0.5

---

mode string

Video generation mode

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

Options: std, pro

Default: std

---

camera_control object

Parameter for controlling camera movement (if not specified, model will intelligently match based on input text/image)

type string

Predefined camera movement type

simple: Simple camera movement, can choose one of six movements in config
down_back: Camera presses down and moves back → down and zoom out, no config needed
forward_up: Camera moves forward and tilts up → push in and move up, no config needed
right_turn_forward: First rotate right then move forward → right turn push in, no config needed
left_turn_forward: First rotate left and move forward → left turn push in, no config needed

Options: simple, down_back, forward_up, right_turn_forward, left_turn_forward

config object

Contains six fields for specifying camera movement or changes in different directions

Required when type is simple, not needed for other types
Choose one of the following 6 parameters, only one can be non-zero, others must be 0

horizontal number

Horizontal movement, controls camera horizontal movement (translation along x-axis)

Range: -10 - 10, negative moves left, positive moves right

vertical number

Vertical movement, controls camera vertical movement (translation along y-axis)

Range: -10 - 10, negative moves down, positive moves up

pan number

Horizontal pan, controls camera rotation on horizontal plane (rotation around y-axis)

Range: -10 - 10, negative rotates left, positive rotates right

tilt number

Vertical tilt, controls camera rotation on vertical plane (rotation around x-axis)

Range: -10 - 10, negative tilts down, positive tilts up

roll number

Roll movement, controls camera roll (rotation around z-axis)

Range: -10 - 10, negative rotates counter-clockwise, positive rotates clockwise

zoom number

Zoom, controls camera focal length change, affects field of view distance

Range: -10 - 10, negative zooms in (smaller FOV), positive zooms out (larger FOV)

---

watermark_info array

Whether to generate results with watermark simultaneously

Defined by enabled parameter, specific array 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 task status changes

---

external_task_id string

Custom task ID

User-defined task ID. Input will not overwrite system-generated task ID, but supports task query through this ID

Please note, must ensure uniqueness 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
002001095	Internal generation error
002001096	Result parsing error
002001097	HTTP error response
002001098	Status check error
002001099	Task creation error