Midjourney 接口总览

概览#

Midjourney 接口兼容 MJ Proxy 协议，覆盖文生图、图生文、混图、放大、变体、平移、局部重绘、视频等完整动作。所有接口均需 Bearer Token 鉴权，采用异步任务模式：提交后返回任务 ID，轮询获取结果。

• 提交端点统一在 /mj/submit/*，查询走 GET /mj/task/:id/fetch
• 每个动作对应一个计费模型（mj_imagine、mj_describe 等），按次计费
• 结果图上的按钮交互（放大、变体等）通过 /mj/submit/change 的 action 字段提交

快速开始#

文生图：

curl --request POST \
  --url https://api.apimax.ai/mj/submit/imagine \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "a cute cat sitting on the grass --ar 16:9"
  }'

响应：

{
  "code": 1,
  "description": "Submit success",
  "result": "1791517439018579"
}

result 为任务 ID。查询任务进度与结果：

curl 'https://api.apimax.ai/mj/task/1791517439018579/fetch' \
  --header 'Authorization: Bearer <token>'

任务完成后，响应中的 imageUrl 为 4 宫格结果图，buttons 为可继续交互的按钮（其 customId 用于二次动作提交）。

提交端点一览#

change 支持的 action#

请求体携带 action 与 customId（来自结果 buttons）：

动作与价格#

全部动作按次计费（默认 fast 模式）：

任务状态#

SUBMITTED → IN_PROGRESS → SUCCESS / FAILURE

模式说明#

默认为 fast 模式。可在提示词末尾追加 --relax（低价慢速）或 --turbo（高价加速）切换生成模式；当前计费统一按 fast 档收取，与所选模式无关。

错误处理#