跳转到主要内容
POST
图生视频
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 midjourney-video,参数放进 input。两种写法效果与计费完全一样。
提交后返回任务 ID,用 查询结果 取图,或者提交时带上 notify_hook 等推送。完成后结果里的 actions 列出还能接着做的加工,调 图像操作 继续。 这个接口用你自己的图做首帧。要用某个任务里的图做视频、或者延长视频,调 图像操作,action 填 video 或 video-extend。

授权

Authorization
string
header
必填

在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。

请求体

application/json
image
string
必填

首帧:图片 URL(公网可访问)或 base64 data URI,单张不超过 20 MB。

prompt
string

提示词:可选:描述画面怎么动。不写时自动按画面生成运动。

Maximum string length: 6000
resolution
enum<string>
默认值:480p

分辨率:480p(默认)或 720p(3.2 倍价格)。

可用选项:
480p,
720p
motion
enum<string>
默认值:low

运动幅度:low 低运动(默认,适合静态场景)/ high 高运动(大幅镜头运动)。

可用选项:
low,
high
batch_size
enum<integer>
默认值:1

视频数量:一次生成几个视频:1(默认)、2 或 4,价格按数量计。

可用选项:
1,
2,
4
end_image
string

尾帧:可选:视频最后一帧的图。图片 URL(公网可访问)或 base64 data URI,单张不超过 20 MB。

loop
boolean
默认值:false

循环:生成首尾相同的循环视频,不能和尾帧同时用。

speed
enum<string>
默认值:fast

速度:视频只支持快速(fast)与极速(turbo)。也可以在提示词里写 --fast / --turbo,请求参数优先。

可用选项:
fast,
turbo
notify_hook
string<uri>

推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。

响应

OK

task_id
string
必填

任务 ID。

action
string
必填

动作名,例如 imagine、upscale。

status
enum<string>
必填

任务状态,取值见上表。

可用选项:
submitted,
in_progress,
success,
failure
created_at
integer
必填

创建时间(Unix 秒)。