接口提示
kirin_v1_5_i2v 仅在 mode 为 pro 时支持首尾帧或仅尾帧（image + image_tail 或仅 image_tail）
kirin_v1_5_i2v 仅在 mode 为 pro 且 duration 为 5 秒时支持运动笔刷（dynamic_masks/static_mask）
kirin_v1_5_i2v 仅在 mode 为 pro 且 duration 为 5 秒时支持运镜控制（camera_control, 仅 simple）
认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
可选值: kirin_v1_5_i2v
data object 必填
数据参数对象
image
string参考图像
支持传入图片 Base64 编码或图片 URL（确保可访问）
注意： 若您使用 Base64 的方式, 请确保您传递的所有图像数据参数均采用 Base64 编码格式. 在提交数据时, 请不要在 Base64 编码字符串前添加任何前缀, 例如
data:image/png;base64,. 正确的参数格式应该直接是 Base64 编码后的字符串.图片要求：
格式：.jpg、.jpeg、.png
大小：不超过10MB
尺寸：宽高不小于300px, 宽高比介于1:2.5~2.5:1之间
image参数与image_tail参数至少二选一, 二者不能同时为空image + image_tail 参数、dynamic_masks/static_mask 参数、camera_control 参数三选一, 不能同时使用
image_tail
string参考图像 - 尾帧控制
支持传入图片 Base64 编码或图片 URL（确保可访问）
注意： 若您使用 Base64 的方式, 请确保您传递的所有图像数据参数均采用 Base64 编码格式. 在提交数据时, 请不要在 Base64 编码字符串前添加任何前缀, 例如
data:image/png;base64,. 正确的参数格式应该直接是 Base64 编码后的字符串.图片要求：
格式：.jpg、.jpeg、.png
大小：不超过10MB
尺寸：宽高不小于300px
image参数与image_tail参数至少二选一, 二者不能同时为空image + image_tail 参数、dynamic_masks/static_mask 参数、camera_control 参数三选一, 不能同时使用
prompt
string视频生成提示词, 长度不超过
2500字符
duration
string视频时长
可选值:
5、10默认值:
5
cfg_scale
number生成视频的自由度. 值越大, 模型自由度越小, 与用户输入的提示词相关性越强
范围:
0-1默认值:
0.5
seed
integer随机种子
negative_prompt
string负向文本提示词, 不超过
2500个字符
mode
string生成视频的模式
std：标准模式, 基础模式, 性价比高
pro：专家模式（高品质）, 高表现模式, 生成视频质量更佳可选值:
std、pro默认值:
std
static_mask
string静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）
“运动笔刷”能力包含”动态笔刷 dynamic_masks”和”静态笔刷 static_mask”两种
支持传入图片 Base64 编码或图片 URL（确保可访问, 格式要求同 image 字段）
图片格式支持
.jpg、.jpeg、.png图片长宽比必须与输入图片相同（即 image 字段）, 否则任务失败（failed）
static_mask 和 dynamic_masks.mask 这两张图片的分辨率必须一致, 否则任务失败（failed）
dynamic_masks
array动态笔刷配置列表
可配置多组（最多 6 组）, 每组包含”涂抹区域 mask”与”运动轨迹 trajectories”序列
mask
string动态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）
支持传入图片 Base64 编码或图片 URL（确保可访问, 格式要求同 image 字段）
图片格式支持
.jpg、.jpeg、.png图片长宽比必须与输入图片相同（即 image 字段）, 否则任务失败（failed）
static_mask 和 dynamic_masks.mask 这两张图片的分辨率必须一致, 否则任务失败（failed）
trajectories
array运动轨迹坐标序列
生成 5s 的视频, 轨迹长度不超过 77, 即坐标个数取值范围：
[2, 77]轨迹坐标系, 以图片左下角为坐标原点
注 1：坐标点个数越多轨迹刻画越准确, 如只有 2 个轨迹点则为这两点连接的直线
注 2：轨迹方向以传入顺序为指向, 以最先传入的坐标为轨迹起点, 依次链接后续坐标形成运动轨迹
x
integer轨迹点横坐标（在像素二维坐标系下, 以输入图片 image 左下为原点的像素坐标）
y
integer轨迹点纵坐标（在像素二维坐标系下, 以输入图片 image 左下为原点的像素坐标）
camera_control
object控制摄像机运动的协议（如未指定, 模型将根据输入的文本/图片进行智能匹配）
image + image_tail 参数、dynamic_masks/static_mask 参数、camera_control 参数三选一, 不能同时使用
type
string预定义的运镜类型
Options:
simple
simple：简单运镜, 可在 “config” 中六选一进行运镜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
string是否同时生成含水印的结果
通过 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资源类型, 例如
videourl
string生成内容 URL
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总成本（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 00200301 | 图像缺失 |
| 00200302 | 图像格式无效 |
| 00200303 | 提示词长度无效 |
| 00200304 | 时长无效 |
| 00200305 | 宽高比无效 |
| 00200306 | 认证失败 |
| 00200398 | 生成失败 |
| 00200399 | 服务不可用 |