⌘K

Kirin V1.6 - Text to Video

kirin_v1_6_t2v

高质量视频生成,具有可靠的动作一致性和稳定的场景理解.

接口提示

kirin_v1_6_t2vstd 模式下生成的视频分辨率为 720p,帧率为 24fps.

kirin_v1_6_t2vpro 模式下生成的视频分辨率为 1080p,帧率为 24fps.

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

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

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

可选值: kirin_v1_6_t2v


prompt string 必填

视频生成提示词, 不超过 2500 个字符


negative_prompt string

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


cfg_scale number

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

范围: 0 - 1


mode string

生成视频的模式

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

可选值: stdpro

默认值: std


aspect_ratio string

生成视频的画面纵横比(宽:高)

可选值: 16:99:161:1

默认值: 16:9


duration number

视频时长(秒)

可选值: 510

默认值: 5


watermark_info array

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

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

"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

url string

生成内容 URL


usage object

使用统计, 仅在状态为 completed 时存在

cost string

总成本(美元)

discount number

折扣金额


metadata object

元数据信息


错误码

错误码描述
002004095内部生成错误
002004096结果解析异常
002004097HTTP 错误响应
002004098状态检查异常
002004099任务创建异常