跳转到主要内容
POST
创建图生视频任务

模型参数详细规则

根据 model 的值,各参数的必填状态和有效范围如下:
名称:标准模型-多参考图生视频特性:强制使用多参考图输入。

回调通知

视频生成任务处理完成后,服务将向发起请求中提供的 callback_url 发送一个 POST 请求。

结构

code
integer
响应状态码。0 表示回调发送成功。
msg
string
响应消息,通常为 “ok”。
task_type
string
任务类型。枚举值:image_to_video
data
object
包含生成结果的数据载体。

回调示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

创建图生视频任务,使用 KL 模型。

model
enum<string>
必填

模型标识符。

  • KL:多参考图模式。
可用选项:
KL
示例:

"KL"

prompt
string
必填

视频生成提示词,限制 1000 字符。

示例:

"一只金毛犬在草地上奔跑,阳光明媚,电影级光影"

aspect_ratio
enum<string>
必填

视频宽高比。

可用选项:
16:9,
9:16
示例:

"16:9"

aspect_resolution
enum<string>
必填

视频分辨率。支持 720p、1080p。

可用选项:
720p,
1080p
示例:

"1080p"

duration
enum<integer>
必填

视频时长(秒)。支持 5 或 10。

可用选项:
5,
10
示例:

5

reference_images
string<uri>[]

参考图片 URL 列表(必填)。每张图片最大 20MB。

Maximum array length: 5
示例:
generate_count
integer
默认值:1

生成视频数量(1-4)。

必填范围: 1 <= x <= 4
示例:

1

callback_url
string<uri>

任务完成回调通知 URL。

示例:

"https://your-server.com/callback"

响应

任务创建成功

任务创建响应

code
integer
必填

状态码(0 表示成功)

示例:

0

msg
string
必填

响应消息

示例:

"ok"

data
object
必填

包含生成的任务 ID 的数据