简介
更新日志
2024.11.15
视频生成
- 正式开放可灵V1.5模型调用,支持视频生成 - 图生视频,暂不支持文生视频
- model_name 设置为 kling-v1-5
- 仅支持高品质模式
- 不支持尾帧控制
- 其他参数均支持
- 新增能力:视频延长
- 支持对V1.0模型生成的视频直接进行延长,每次增加4-5s的视频时长
- 包括创建任务、查询任务(单个)、查询任务(列表)接口
- 其他
- 新增“external_task_id”字段,您可以在创建任务时自定义任务id,查询时也可以通过该自定义id查询视频
2024.10.25
- 增加对于模型生成物(图片/视频)存储时长的说明
- 为保障信息安全,生成的图片/视频会在30天后被清理,辛苦大家及时转存
2024.9.19
视频生成相关API
- 创建任务时,请求参数里的正向提示词(prompt)和负向提示词(negative_prompt),字符数限制更新为:不超过2500个字符
- 正式支持“AI虚拟试穿”相关API(kolors-virtual-try-on)
API 请求参数说明
请求头字段
字段名 | 值 | 描述 |
---|---|---|
Content-Type | application/json | 数据交换格式 |
Authorization | 鉴权信息,参考接口鉴权 | 鉴权信息,参考接口鉴权 |
请求体字段
字段名 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
model_name | string | 可选 | kling-v1 | 模型名称 ● 枚举值:kling-v1 ,kling-v1-5 |
prompt | string | 必须 | 无 | 正向文本提示词 ● 不能超过2500个字符 |
negative_prompt | string | 可选 | 空 | 负向文本提示词 ● 不能超过2500个字符 |
cfg_scale | float | 可选 | 0.5 | 生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强 ● 取值范围:[0, 1] |
mode | string | 可选 | std | 生成视频的模式 ● 枚举值:std,pro ● std:标准模式(标准),基础模式,性价比高 ● pro:专家模式(高品质),高表现模式,生成视频质量更佳 |
camera_control | object | 可选 | 空 | 控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配) 截止20241115:仅kling-v1模型5s&标准std的情况下支持镜头控制,其他情况不支持 |
camera_control
字段名 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
type | string | 可选 | 无 | 预定义的运镜类型 ● 枚举值:"simple", "down_back", "forward_up", "right_turn_forward", "left_turn_forward" ● simple:简单运镜,此类型下可在"config"中六选一进行运镜 ● down_back:镜头下压并后退 ➡️ 下移拉远,此类型下config参数无需填写 ● forward_up:镜头前进并上仰 ➡️ 推进上移,此类型下config参数无需填写 ● right_turn_forward:先右旋转后前进 ➡️ 右旋推进,此类型下config参数无需填写 ● left_turn_forward:先左旋并前进 ➡️ 左旋推进,此类型下config参数无需填写 |
config
字段名 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
horizontal | float | 可选 | 无 | 水平运镜,控制摄像机在水平方向上的移动量(沿x轴平移) ● 取值范围:[-10, 10],负值表示向左平移,正值表示向右平移 |
vertical | float | 可选 | 无 | 垂直运镜,控制摄像机在垂直方向上的移动量(沿y轴平移) ● 取值范围:[-10, 10],负值表示向下平移,正值表示向上平移 |
pan | float | 可选 | 无 | 水平摇镜,控制摄像机在水平面上的旋转量(绕y轴旋转) ● 取值范围:[-10, 10],负值表示绕y轴向左旋转,正值表示绕y轴向右旋转 |
tilt | float | 可选 | 无 | 垂直摇镜,控制摄像机在垂直面上的旋转量(沿x轴旋转) ● 取值范围:[-10, 10],负值表示绕x轴向下旋转,正值表示绕x轴向上旋转 |
roll | float | 可选 | 无 | 旋转运镜,控制摄像机的滚动量(绕z轴旋转) ● 取值范围:[-10, 10],负值表示绕z轴逆时针旋转,正值表示绕z轴顺时针旋转 |
zoom | float | 可选 | 无 | 变焦,控制摄像机的焦距变化,影响视野的远近 ● 取值范围:[-10, 10],负值表示焦距变长、视野范围变小,正值表示焦距变短、视野范围变大 |
字段名 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
aspect_ratio | string | 可选 | 16:9 | 生成视频的画面纵横比(宽:高) ● 枚举值:16:9, 9:16, 1:1 |
duration | string | 可选 | 5 | 生成视频时长,单位s ● 枚举值:5,10 |
callback_url | string | 可选 | 无 | 本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知 ● 具体通知的消息schema见“Callback协议” |
external_task_id | string | 可选 | 无 | 自定义任务ID ● 用户自定义任务ID,传入不会覆盖系统生成的任务ID,但支持通过该ID进行任务查询 ● 请注意,单用户下需要保证唯一性 |
最后修改时间: 15 天前