⌘K

Kirin V2.6 - Image to Video

kirin_v2_6_i2v

先进的图生视频生成,支持语音合成和增强的运动控制.

接口提示

kirin_v2_6_i2v 仅在 modeprosoundon 时支持有声视频.

kirin_v2_6_i2v 仅在 modepro 时支持 imageimage_tail 参数同时使用(首尾帧).

kirin_v2_6_i2v 通过首尾帧(同时使用 imageimage_tail 参数)生成的视频无声.

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

访问 API Key 管理页面 获取 API Key

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

: kirin_v2_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 参数与 image_tail 参数至少二选一,二者不能同时为空


image_tail 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 参数至少二选一,二者不能同时为空

注意:仅在 modepro 时支持首尾帧,且通过首尾帧生成的视频无声


prompt string

正向文本提示词, 不超过 2500 个字符

使用 <<<voice_1>>> 指定音色,序号对应 voice_list 参数所引用音色的排列顺序

一次视频生成任务至多引用 2 个音色. 指定音色时, sound 参数值必须为 on

语法结构越简单越好,如:男人 <<<voice_1>>> 说:“你好”


negative_prompt string

负向文本提示词, 不超过 2500 个字符


mode string

生成视频的模式

std:标准模式, 性价比高
pro:专业模式, 生成视频耗时较长, 但输出的视频质量更高

选项: stdpro

默认值: std


sound string

生成视频时是否同时生成声音

注意:仅在 modepro 时支持

选项: onoff

默认值: off


voice_list array

生成视频时所引用的音色列表

一次视频生成任务至多引用 2 个音色

voice_list 参数不为空且 prompt 参数中引用音色 ID 时,视频生成任务按”有指定音色”计量计费


duration string

视频时长(秒)

选项: 510

默认值: 5


watermark_info array

是否同时生成含水印的结果

通过 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

资源类型,如 video

url string

生成内容的 URL


usage object

使用统计, 仅在状态为 completed 时存在

cost string

总费用(美元)

discount number

折扣金额


metadata object

元数据信息


错误码

错误码描述
002013095内部生成错误
002013096结果解析异常
002013097HTTP 错误响应
002013098状态检查异常
002013099任务创建异常