视频生成 · API v1

Midjourney Video 视频 API

通过文字或参考图片生成视频，使用独立 API 积分。

POST/api/v1/videos/generations

模型与参数

modelId

midjourney-video

prompt

使用参考图时必填；关联任务时可省略

imageSize

480p / 720p

duration

固定约 5 秒

generationSpeed

string；relax / fast / turbo；默认 relax，视频速度同价

referenceUrls

string[]；恰好一张公开 HTTP(S) 参考图 URL，与 parentTaskId 二选一

imageAdvanced.videoMode

enum；image-to-video / start-end；image-to-video / start-end；提供 endUrl 自动使用 start-end

imageAdvanced.animateMode

enum；manual / auto；manual / auto；auto 必须提供父任务和 index

imageAdvanced.motion

enum；low / high；low / high；默认 high

imageAdvanced.batchSize

enum；1 / 2 / 4；1 / 2 / 4，默认 1，按实际交付视频数量结算

imageAdvanced.index

number；0–3；图像操作选择四宫格第 1–4 张；视频为 0–3

imageAdvanced.generationIndex

number；1–100；关联任务的第几次生成请求，从 1 开始

imageAdvanced.contentFilter

boolean；是否启用内容过滤；模型自身规则仍然适用

imageAdvanced.parentTaskId

string；本站 Midjourney API 任务 ID；只能引用本人任务

imageAdvanced.endUrl

string；公开 HTTP(S) 尾帧图片 URL

imageAdvanced.metadata

object；最多 4096 字符的 JSON 对象，仅保存调用方提供的附加数据

每次按 batchSize 输出 1、2 或 4 个视频。参考图片数量、首尾帧和参考图模式以模型支持能力为准；不支持的组合会返回参数错误。

使用一张 referenceUrls 并提供提示词，或使用 imageAdvanced.parentTaskId 引用本人已完成的 Midjourney 图像任务；两者不能同时提供。视频 index 从 0 开始。batchSize 支持 1、2、4；endUrl 指定尾帧。结果通过本站 task.videos[].url 下载。

报价与 API 积分

详细价格表

6 个价格档位

Midjourney Video API 调用价格
分辨率	视频数量	API 积分 / 次
480p	1	0.3434
480p	2	0.6868
480p	4	1.3736
720p	1	0.6868
720p	2	1.3736
720p	4	2.7472

1 美元 = 1 API 积分。

约 5 秒视频，按分辨率和数量收费；首尾帧、运动强度和动画模式同价。

默认配置：每次 0.3434 API 积分（5 秒）。向 POST /api/v1/videos/quote 提交相同参数查询 estimatedPoints；报价不创建任务，也不冻结积分。分辨率、时长、声音与快速模式可能影响价格。

1 美元 = 1 API 积分，支持小数。API 钱包和价格独立，不享受网站会员折扣。提交时冻结 API 积分，任务结束后按模型规则结算。充值 API 积分

查询与下载视频

成功提交返回 HTTP 202 和 taskId。每 3–5 秒请求 GET /api/v1/tasks/{taskId}，queued 和 processing 状态继续等待；succeeded、partial、failed 状态停止轮询。settled 为 true 时，chargedPoints 是最终扣费。

task.videos[].url 是本站视频下载路径，下载也必须携带 API Key。视频遵循本站保留期限，过期返回 410，请及时下载保存。只能访问本人 API 任务。

幂等重试

每个新任务设置不同的 Idempotency-Key，8–128 位字母、数字或 ._:-。超时重试保持相同键和参数，避免重复冻结；改变参数返回 409。有效密钥不设请求频率和网页会员并发上限。

错误处理

400 参数或报价组合无效；401 密钥无效；402 API 积分不足；404 任务不存在或无权访问；409 幂等冲突；410 视频已过期；5xx 服务暂不可用。错误包含 error 和 code，不返回内部调用信息。