接口说明

Midjourney 是围绕"生成 → 查询 → 对结果做二次操作"的异步任务协议。鉴权方式与其他接口一致，见鉴权。本页是协议总览，各操作的字段与父任务要求见操作详解。

模式选择

按目标选择操作：

imagine(生成)
  └─ SUCCESS → 四宫格 grid_image_url + buttons
       ├─ upscale / variation / high_variation / low_variation(引用 index 或 buttons 中的 custom_id)
       ├─ reroll / pan / zoom(引用 buttons 中的 custom_id)
       ├─ remix_strong / remix_subtle
       ├─ inpaint → MODAL → modal(局部重绘,两步流程)
       └─ video(把某一张结果做成视频)

只有**原始 imagine（或 blend/zoom/reroll 等同样产出新一组四宫格候选图的任务）**的查询响应才带 buttons 数组；upscale/variation 等选中单张图的结果不带 buttons。用 custom_id 引用二次操作时，必须从产出该四宫格的那个任务的响应里取，不能从 upscale 之类的下游结果里取。

全部 16 个操作端点的字段、父任务要求与示例见操作详解。

快速开始

两个路径等价。

curl https://api.vibelab.me/v1/midjourney/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cat in a spacesuit --ar 16:9"}'

提交成功返回 202，data[0].task_id 即后续轮询用的任务 ID：

{"code": 200, "data": [{"task_id": "mj_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "submitted"}]}

轮询：

curl https://api.vibelab.me/v1/midjourney/mj_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY"

字段见响应。

请求参数

imagine 基础参数

结构化参数

作为 -- 前缀写法的等价 JSON 字段透传给上游。平台本身不校验取值范围，非法值由上游处理。仅在 prompt 文本内联写 --ar 经过真实调用验证；以下结构化字段建议优先用于替代对应的 -- 写法，与 prompt 内联写法冲突时以上游实际行为为准。

版本与 Niji

• version 传主版本号字符串。当前上游可用："8.2"、"8.1"、"7"、"6.1"、"5.2"、"5.1"。
• 用 Niji（动漫模型）：传 niji: true 加 version: "7" 或 "6"，上游会归一化为 Niji 7 / Niji 6。不要只传 niji: true 而不给版本。
• 版本会影响哪些操作可用：pan 只在 v6/v6.1/v7/v8.1/v8.2/niji6 上有效，remix_strong/remix_subtle 只在 v8.1/v8.2 上有效。详见操作详解。
• 版本不影响价格，各版本同档同价。

请求示例

Niji 竖图

{"prompt": "anime girl in a moonlit garden", "niji": true, "version": "7", "size": "9:16"}

响应

task_id 为提交响应中的值（mj_ 前缀 + UUID）。任务不存在、或不属于当前 API Key 所在账户 → 404 task_not_found。查询响应直接是任务对象，不套 {"code", "data"} 外壳。

状态机

响应示例（SUCCESS，四宫格）：

{
  "id": "mj_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "action": "IMAGINE",
  "status": "SUCCESS",
  "progress": "100%",
  "prompt": "a cat in a spacesuit --ar 16:9",
  "created_at": 1789041600,
  "completed_at": 1789041660,
  "credits_charged": 0.58552,
  "grid_image_url": "https://...",
  "image_urls": ["https://...", "https://...", "https://...", "https://..."],
  "buttons": [{"customId": "MJ::JOB::upsample::1::..."}]
}

任务对象字段

所有状态都包含：

进入终态后追加：

SUCCESS 时，按操作类型追加以下之一：

FAILURE 时追加：

结果有效期

生成结果会被平台转存到自有对象存储并签发可直接访问的 URL（grid_image_url/image_urls/video_urls），不依赖上游链接的时效：

响应中不返回单独的过期时间字段，请在拿到 SUCCESS 结果后尽快下载并自行转存，不要长期依赖返回的链接。

计费

单位为积分（credits）。

• inpaint 单独提交不计费，真正的局部重绘发生在随后的 modal 步骤，modal 档位已包含 inpaint+modal 两步的合计成本。
• video 的最终扣费 = 表中单价 × batch_size（可选 1/2/4）。batch_size: 4 就是实扣 4 份：720p 批量 4 段一次要 20.8 积分，比 480p 单段的 2.6 贵 8 倍。只要一段就传 1。
• video_type 含 720 时走 720p 档，其余走 480p 档。
• repeat（2-40）同样按次数倍增扣费，与 batch_size 是两个独立的乘数。
• 任务失败（FAILURE）自动全额退款，退款与终态判定同步完成，无需额外操作。
• 以上价格以定价页和任务终态中的 credits_charged 为准。

注意事项

• variation 和 high_variation 不是"弱一点/强一点"的同一个操作 → variation 作用在四宫格上（等价 V1-V4），high_variation/low_variation 作用在 upscale 之后的单图上；父任务给错，上游会拒。
• inpaint 免费不等于局部重绘免费 → inpaint 那步是 0，但上游对 inpaint 和 modal 分别计费两次，两步的钱一起算在 modal 档里（1.43104，正好是单步的两倍）。走完一轮局部重绘的成本和做两次普通操作一样。
• video 的 batch_size 是实打实的乘数 → 传 4 就扣 4 份；出片只要一段就传 1，比稿才用 4。
• speed 对 video 无效 → video 固定走 FAST 通道，传 relax 或 turbo 既不改价也不改排队；speed 只对生图类操作生效。
• --raw 和 style: "raw" 是两个不同的 flag → 前者对应 raw: true，后者对应 style: "raw"，想要哪个效果就传哪个，不要互相替代。
• pan 挑版本 → 只在 v6/v6.1/v7/v8.1/v8.2/niji6 上有效，v5.2 及更早直接 FAILURE；它只吃 upscale 后的单图，连 HD upscale 的高清单图也被拒，这是 Midjourney 自身的限制。

错误

错误体与错误码相同：{"error": {"message", "type", "code", "request_id"}}（type 与 code 相同）。本接口常见错误：

上游返回的其它 4xx 会按原状态码返回，code 为 invalid_request_error、message 为 upstream request failed。