# Midjourney Video 视频 API

POST /api/v1/videos/generations

使用 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。每次新任务设置不同的 Idempotency-Key，超时重试保持原键和参数。

```json
{
  "modelId": "midjourney-video",
  "prompt": "猫咪缓缓走向窗边",
  "imageSize": "480p",
  "referenceUrls": [
    "https://example.org/start.png"
  ],
  "imageAdvanced": {
    "motion": "high",
    "batchSize": 1
  }
}
```



## 详细价格表

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 积分。1 美元 = 1 API 积分，支持小数。API 独立钱包和售价，不使用网站会员折扣。

分辨率：480p / 720p；比例：auto / 1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 2:3 / 3:2 / 1:2 / 2:1 / 9:21 / 21:9；时长：5–5 秒，步长 1 秒。

参考图生视频：referenceUrls 为可公开访问的图片 URL 数组，videoInputMode 为 keyframes；图片数量与输入模式由模型能力校验。该模型不支持参考视频或音频。

POST /api/v1/videos/quote 使用相同参数，返回 estimatedPoints，不冻结积分。提交成功返回 HTTP 202 和 taskId，冻结 API 积分。

GET /api/v1/tasks/{taskId} 查询状态，成功结果在 task.videos[].url，携带密钥请求本站相对路径下载。视频遵循本站保存期限，请及时下载；过期返回 410。settled 为 true 时 chargedPoints 为最终扣费。失败结算遵循模型规则。


## Midjourney 创作参数

参数放在 imageAdvanced 对象中。每次输出 1、2 或 4 个视频，按实际交付数量结算。所有选项参与报价、任务快照与幂等校验。

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 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 对象，仅保存调用方提供的附加数据 |

使用 modelId=midjourney-video，POST /api/v1/videos/generations。imageSize 为 480p 或 720p，时长固定约 5 秒。referenceUrls（恰好一张，需 prompt）和 imageAdvanced.parentTaskId 二选一。animateMode 为 manual/auto（auto 需要父任务及 index），motion 为 low/high，batchSize 为 1/2/4；endUrl 指定尾帧，自动使用首尾帧模式。index 从 0 开始。按分辨率和 batchSize 预扣，结果在 task.videos[].url。失败全额退款。