跳转到主要内容
用接口调用 Midjourney:生成图片,对图片继续加工,把图片做成视频。所有接口都是异步任务(识图除外):提交后拿到任务 ID,再查询结果,或者提交时带上 notify_hook 等我们推送。

基础信息

每个接口页右侧都有调试面板:填入 API Key 和参数就能直接发请求。调试面板发出的是真实请求,会正常计费。

调用流程

1

提交任务

调新建任务的接口,比如 图像生成,返回 task_id。
2

取回结果

用 查询结果 每 3 到 5 秒查一次,直到 status 变成 success 或 failure。也可以提交时带上 notify_hook,任务结束后我们把和查询结果相同的内容推送过去。
3

接着加工

结果里的 actions 列出还能接着做的加工,调 图像操作,action 填其中一个。新任务完成后也有自己的 actions,可以一直接下去。

全部接口

提交接口的路径是 POST /midjourney/{名字}(名字见下表第一列),查询是 GET /midjourney/task/{task_id}。
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 midjourney- 加动作名(如 midjourney-imagine、midjourney-upscale),参数放进 input,不用传 action。两种方式的任务 ID 通用,计费完全一样。

速度与版本

  • 速度:参数 speed 取 relax(慢速,快速价的 0.4 倍)、fast(默认)或 turbo(极速,快速价的 2 倍)。识图不分速度,视频没有慢速。
  • 版本:在提示词末尾写 --v 7、--niji 7 这样的参数选版本,不写时用 V8.2(Midjourney 现在的默认版本)。加工沿用原图的版本。
  • 提示词:可以照常写 Midjourney 参数,最长 6000 个字符;V8 系列正文在 1024 个字符以内一定能用,更长的可能被拒。各版本的写法与限制见 能力与参数。

计费

按次计费,失败自动退费。每个能力按速度分档的单价见对应模型详情页的价格表;草图、高清、视频分辨率与条数等倍率见 能力与参数。

错误

错误响应统一是这个形状,HTTP 状态码与错误类型对应:
| HTTP | code | 含义 | | --- | --- | | 400 | invalid_request | 参数不对,message 会说明是哪一个 | | 400 | unsupported_action | 这个任务不能做这个操作,以查询结果里的 actions 为准 | | 400 | content_rejected | 提示词或图片没通过内容审核,未扣费 | | 401 | unauthorized | API Key 缺失或无效 | | 402 / 403 | insufficient_quota | 余额不足 | | 404 | task_not_found | 任务不存在,或不属于当前账号 | | 404 | not_found | 接口名写错了 | | 409 | task_not_finished | 要加工的任务还没成功 | | 429 | rate_limited / queue_full | 请求太频繁,或生成队列已满,稍后重试 | | 5xx | upstream_error / internal_error | 服务端故障,可以重试 |

下一步

Midjourney 快速上手

生成第一组图,取回结果,再接着加工

Midjourney 能力与参数

提示词参数、后续操作规则、计费细节