Midjourney API 概览

• Midjourney 文生图（Imagine）/ 垫图 / 二次操作 / 图生视频接口总览
• 异步任务模式：提交后返回 task_id，轮询查询结果
• 新版路由自动注入 model=midjourney，支持原生 MJ 参数、body 结构化参数与 metadata

快速开始

# 1. 提交绘图
curl -X POST https://api.openveer.com/v1/midjourney/generations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'

# 2. 查询结果（推荐轮询统一任务接口直到 status=completed）
curl https://api.openveer.com/v1/tasks/task_01JWXXXX \
  -H "Authorization: Bearer <token>"

# 3. 放大第1张图
curl -X POST https://api.openveer.com/v1/midjourney/generations/upscale \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task_01JWXXXX", "index": 1}'

接口总览

每个功能的完整字段、示例、注意事项见对应子页面。

参考：最佳实践（轮询 / 重试 / 排错） · 完整工作流示例（端到端 curl + 客户端封装）

完整使用流程

flowchart TB
  A["① POST /generations<br/>提交 Imagine"] --> B["② GET /v1/tasks/{task_id}<br/>轮询至 completed"]
  B --> C["③ 如需按钮<br/>GET /v1/midjourney/{task_id}"]
  C --> D1["/upscale"]
  C --> D2["/variation"]
  C --> D3["/reroll"]
  C --> D4["/zoom"]
  C --> D5["/inpaint<br/>(进入 MODAL)"]
  D5 --> M["/modal<br/>提交遮罩 + prompt"]

错误处理

错误响应格式

{
  "error": {
    "type": "invalid_request_error",
    "message": "prompt is required"
  }
}

常见错误

任务失败

fail_reason 常见值：

• Banned prompt detected — 提示词含违禁内容
• Task timeout — 任务超时（超过 30 分钟未完成），已自动退款
• No available upstream — 服务暂不可用，请稍后重试

计费说明

MJ 新版统一模型名是 midjourney，通过 action、version、speed 生成计费 key。匹配顺序通常为：

midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney

说明：

• speed=relax 或未传 speed 时，不追加 speed 后缀；fast / turbo 会追加对应后缀。
• 主版本归一化为 v8.2、v8.1、v7、v6.1、v5.2、v5.1。
• niji=true + version=7/6 归一化为 niji7 / niji6。

具体价格以控制台模型定价页为准。任务失败会自动全额退款。