认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
值: kirin_v1_6_multi_i2v
image_list array 必填
参考图片列表, 最多支持 4 张图片, 每张以 image 为 key 传入 URL 或 Base64 字符串:
"image_list": [
{ "image": "image_url_or_base64" },
{ "image": "image_url_or_base64" }
]
API 端无裁剪逻辑, 请直接上传已选主体后的图片
支持传入图片 Base64 编码或图片 URL(确保可访问)
注意:若使用 Base64 方式, 请不要在 Base64 编码字符串前添加任何前缀(如 data:image/png;base64,), 直接传递 Base64 编码后的字符串即可
图片格式支持 .jpg / .jpeg / .png
图片文件大小不能超过 10MB, 图片宽高不小于 300px, 宽高比介于 1:2.5 ~ 2.5:1 之间
image
string必填图片 URL 或 Base64 编码字符串
prompt string 必填
正向文本提示词
不能超过 2500 个字符
negative_prompt string
负向文本提示词
不能超过 2500 个字符
mode string
生成视频的模式
默认值: std
可选值: std、pro
std:标准模式, 基础模式, 性价比高
pro:专家模式(高品质), 高表现模式, 生成视频质量更佳
duration string
生成视频时长, 单位秒
默认值: 5
可选值: 5、10
aspect_ratio string
生成视频的画面纵横比(宽:高)
默认值: 16:9
可选值: 16:9、9:16、1:1
watermark_info object
是否同时生成含水印的结果, 暂不支持自定义水印
enabled
boolean
true:生成含水印的结果
false:不生成
callback_url string
本次任务结果回调通知地址, 如果配置, 服务端会在任务状态发生变更时主动通知
external_task_id string
自定义任务 ID
用户自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询
注:单用户下需要保证唯一性
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
string错误码
message
string详细错误信息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成的资源内容列表
type
string资源类型
值:
image|videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息