接口提示
kirin_v1_6_i2v 仅在 mode 为 pro 时支持首尾帧或仅尾帧(image + image_tail 或仅 image_tail)
kirin_v1_6_i2v 在 std 模式下生成的视频分辨率为 720p, 帧率为 30fps
kirin_v1_6_i2v 在 pro 模式下生成的视频分辨率为 1080p, 帧率为 30fps
认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
可选值: kirin_v1_6_i2v
image string 必填
参考图像
支持传入图片 Base64 编码或图片 URL(确保可访问)
注意: 若您使用 Base64 的方式, 请确保您传递的所有图像数据参数均采用 Base64 编码格式. 在提交数据时, 请不要在 Base64 编码字符串前添加任何前缀, 例如 data:image/png;base64,. 正确的参数格式应该直接是 Base64 编码后的字符串.
图片要求:
格式:.jpg、.jpeg、.png
大小:不超过 10MB
尺寸:宽高不小于 300px, 宽高比介于 1:2.5 ~ 2.5:1 之间
image_tail string
参考图像 - 尾帧控制
支持传入图片 Base64 编码或图片 URL(确保可访问)
注意: 若您使用 Base64 的方式, 请确保您传递的所有图像数据参数均采用 Base64 编码格式. 在提交数据时, 请不要在 Base64 编码字符串前添加任何前缀, 例如 data:image/png;base64,.
图片要求:
格式:.jpg、.jpeg、.png
大小:不超过 10MB
尺寸:宽高不小于 300px
image 参数与 image_tail 参数至少二选一, 二者不能同时为空
prompt string
视频生成提示词, 长度在 1 - 2500 字符之间
mode string
生成视频的模式
std:标准模式, 基础模式, 性价比高
pro:专家模式(高品质), 高表现模式, 生成视频质量更佳
选项: std、pro
默认值: std
negative_prompt string
负向文本提示词, 不能超过 2500 个字符
cfg_scale number
生成视频的自由度; 值越大, 模型自由度越小, 与用户输入的提示词相关性越强
范围: 0 - 1
默认值: 0.5
duration string
生成视频时长, 单位秒
选项: 5, 10
默认值: 5
watermark_info array
是否同时生成含水印的结果
通过 enabled 参数定义, 具体 array 格式如下:
"watermark_info": {
"enabled": boolean // true 为生成, false 为不生成
}
暂不支持自定义水印
callback_url string
本次任务结果回调通知地址, 如果配置, 服务端会在任务状态发生变更时主动通知
external_task_id string
自定义任务 ID
用户自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询
请注意, 单用户下需要保证唯一性
callback string
回调 URL
轮询
由于视频生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息.仅在状态为 failed 时出现.
code
string错误码
error_message
string详细错误信息
output array
生成结果.仅在状态为 completed 时出现.
content
array生成内容列表
type
string资源类型,如
video,imageurl
string生成内容的 URL
duration
number视频时长
jobId
string远程任务 ID
usage object
使用统计.仅在状态为 completed 时出现.
cost
string总费用 (美元)
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 0 | 无错误 |
| 8002005001 | 图像缺失 |
| 8002005002 | 图像格式无效 |
| 8002005003 | 提示词长度无效 |
| 8002005004 | 时长无效 |
| 8002005005 | 宽高比无效 |
| 8002005006 | JWT 认证失败 |
| 8002005098 | 生成过程失败 |
| 8002005099 | 提供方不可用 |