接口提示
kirin_v2_6_t2v 仅在 mode 为 pro 且 sound 为 on 时支持有声视频.
认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
值: kirin_v2_6_t2v
prompt string 必填
视频生成提示词, 最多 2500 字符
negative_prompt string
负向文本提示词, 不超过 2500 个字符
sound string
生成视频时是否同时生成声音
注意:仅在 mode 为 pro 时支持
选项: on、off
默认值: off
mode string
生成视频的模式
std:标准模式, 基础模式, 性价比高
pro:专家模式(高品质), 高表现模式, 生成视频质量更佳
选项: std、pro
默认值: std
aspect_ratio string
生成视频的画面纵横比(宽:高)
选项: 16:9、9:16、1:1
默认值: 16:9
duration string
生成视频时长(秒)
选项: 5、10
默认值: 5
watermark_info string
是否同时生成含水印的结果
通过 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资源类型,如
videourl
string生成内容的 URL
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 002014095 | 内部生成错误 |
| 002014096 | 结果解析异常 |
| 002014097 | HTTP 错误响应 |
| 002014098 | 状态检查异常 |
| 002014099 | 任务创建异常 |