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