Kirin V1 - Text to Video | Vtrix API Docs

接口提示

kirin_v1_t2v 仅在 mode 为 std 且 duration 为 5 秒时支持运镜控制（camera_control）

kirin_v1_t2v 在 std 和 pro 模式下生成的视频分辨率均为 720p, 帧率均为 30fps

认证

authorization `string` 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model `string` 必填

请求使用的模型 ID

值：kirin_v1_t2v

prompt `string` 必填

视频生成提示词, 必须提供且长度在 1-2500 字符之间

duration `string`

视频时长（秒）

可选值: 5, 10

默认值: 5

aspect_ratio `string`

生成视频的画面纵横比（宽:高）

可选值: 16:9, 9:16, 1:1

默认值: 16:9

negative_prompt `string`

负向文本提示词, 不能超过 2500 个字符

cfg_scale `number`

生成视频的自由度; 值越大, 模型自由度越小, 与用户输入的提示词相关性越强

范围: 0 - 1

默认值: 0.5

mode `string`

生成视频的模式

std：标准模式（标准）, 基础模式, 性价比高
pro：专家模式（高品质）, 高表现模式, 生成视频质量更佳

选项: std, pro

默认值: std

camera_control `object`

控制摄像机运动的参数（如未指定, 模型将根据输入文本/图像智能匹配）

type string

预定义的运镜类型

simple：简单运镜, 此类型下可在 config 中六选一进行运镜
down_back：镜头下压并后退 ➡️ 下移拉远, 此类型下 config 参数无需填写
forward_up：镜头前进并上仰 ➡️ 推进上移, 此类型下 config 参数无需填写
right_turn_forward：先右旋转后前进 ➡️ 右旋推进, 此类型下 config 参数无需填写
left_turn_forward：先左旋并前进 ➡️ 左旋推进, 此类型下 config 参数无需填写

选项: simple, down_back, forward_up, right_turn_forward, left_turn_forward

config object

包含六个字段, 用于指定摄像机在不同方向上的运动或变化

当运镜类型指定 simple 时必填, 指定其他类型时不填
以下参数 6 选 1, 即只能有一个参数不为 0, 其余参数为 0

horizontal number

水平运镜, 控制摄像机在水平方向上的移动量（沿 x 轴平移）

范围: -10 - 10, 负值表示向左平移, 正值表示向右平移

vertical number

垂直运镜, 控制摄像机在垂直方向上的移动量（沿 y 轴平移）

范围: -10 - 10, 负值表示向下平移, 正值表示向上平移

pan number

水平摇镜, 控制摄像机在水平面上的旋转量（绕 y 轴旋转）

范围: -10 - 10, 负值表示绕 y 轴向左旋转, 正值表示绕 y 轴向右旋转

tilt number

垂直摇镜, 控制摄像机在垂直面上的旋转量（沿 x 轴旋转）

范围: -10 - 10, 负值表示绕 x 轴向下旋转, 正值表示绕 x 轴向上旋转

roll number

旋转运镜, 控制摄像机的滚动量（绕 z 轴旋转）

范围: -10 - 10, 负值表示绕 z 轴逆时针旋转, 正值表示绕 z 轴顺时针旋转

zoom number

变焦, 控制摄像机的焦距变化, 影响视野的远近

范围: -10 - 10, 负值表示焦距变长、视野范围变小, 正值表示焦距变短、视野范围变大

watermark_info `array`

是否同时生成含水印的结果

通过 enabled 参数定义, 具体 array 格式如下：

"watermark_info": {
  "enabled": boolean // true 为生成, false 为不生成
}

暂不支持自定义水印

callback_url `string`

本次任务结果回调通知地址, 如果配置, 服务端会在任务状态发生变更时主动通知

external_task_id `string`

自定义任务 ID

用户自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询

请注意, 单用户下需要保证唯一性

轮询

由于视频生成需要时间, 您需要在创建任务后轮询任务状态

初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取

响应格式

error `object`

错误信息. 仅在状态为 failed 时出现

code string

错误码

error_message string

详细错误信息

output `array`

生成结果. 仅在状态为 completed 时出现

content array

生成内容列表

type string

资源类型, 如 video, image

url string

生成内容的 URL

size string

图像尺寸

usage `object`

使用统计信息. 仅在状态为 completed 时出现

cost string

总费用（美元）

discount number

折扣金额

metadata `object`

元数据信息

错误码

错误码	描述
002001095	内部生成错误
002001096	结果解析错误
002001097	HTTP 错误响应
002001098	状态检查错误
002001099	任务创建错误

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "model": "kirin_v1_t2v", "input": [ { "params": { "prompt": "A cinematic drone shot over a misty mountain range at sunrise", "negative_prompt": "blurry, low quality, distorted", "duration": "5", "aspect_ratio": "16:9", "cfg_scale": 0.5, "mode": "std" } } ] }'

{ "id": "d5u5obte8783ap44qtj0", "created_at": 1769757744021, "status": "completed", "model": "kirin_v1_t2v", "output": [ { "content": [ { "type": "video", "url": "https://example.com/generated-video.mp4", "size": "1920x1080" } ] } ], "usage": { "cost": "0.000500", "discount": 0, "input_tokens": null, "output_tokens": null, "quantity": 1, "time_per_unit": 0, "total_tokens": null, "unit_price": "0.000500", "user_discount": 1 }, "metadata": { "completed_at": 120.5, "in_queue_at": 0, "upload_at": 1.2, "usage": { "input_tokens": 20, "input_tokens_details": { "text_tokens": 20 }, "output_tokens": 0, "total_tokens": 20 } } }

Kirin V1 - Text to Video

接口提示

认证

authorization `string` 必填

参数

model `string` 必填

prompt `string` 必填

duration `string`

aspect_ratio `string`

negative_prompt `string`

cfg_scale `number`

mode `string`

camera_control `object`

type `string`

config `object`

horizontal `number`

vertical `number`

pan `number`

tilt `number`

roll `number`

zoom `number`

watermark_info `array`

callback_url `string`

external_task_id `string`

轮询

响应格式

error `object`

code `string`

error_message `string`

output `array`

content `array`

type `string`

url `string`

size `string`

usage `object`

cost `string`

discount `number`

metadata `object`

错误码

接口提示

认证

authorization string 必填

参数

model string 必填

prompt string 必填

duration string

aspect_ratio string

negative_prompt string

cfg_scale number

mode string

camera_control object

type string

config object

horizontal number

vertical number

pan number

tilt number

roll number

zoom number

watermark_info array

callback_url string

external_task_id string

轮询

响应格式

error object

code string

error_message string

output array

content array

type string

url string

size string

usage object

cost string

discount number

metadata object

错误码

authorization `string` 必填

model `string` 必填

prompt `string` 必填

duration `string`

aspect_ratio `string`

negative_prompt `string`

cfg_scale `number`

mode `string`

camera_control `object`

type `string`

config `object`

horizontal `number`

vertical `number`

pan `number`

tilt `number`

roll `number`

zoom `number`

watermark_info `array`

callback_url `string`

external_task_id `string`

error `object`

code `string`

error_message `string`

output `array`

content `array`

type `string`

url `string`

size `string`

usage `object`

cost `string`

discount `number`

metadata `object`