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}。
速度与版本
- 速度:参数
speed取relax(慢速,快速价的 0.4 倍)、fast(默认)或turbo(极速,快速价的 2 倍)。识图不分速度,视频没有慢速。 - 版本:在提示词末尾写
--v 7、--niji 7这样的参数选版本,不写时用 V8.2(Midjourney 现在的默认版本)。加工沿用原图的版本。 - 提示词:可以照常写 Midjourney 参数,最长 6000 个字符;V8 系列正文在 1024 个字符以内一定能用,更长的可能被拒。各版本的写法与限制见 能力与参数。
计费
按次计费,失败自动退费。每个能力按速度分档的单价见对应模型详情页的价格表;草图、高清、视频分辨率与条数等倍率见 能力与参数。错误
错误响应统一是这个形状,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 能力与参数
提示词参数、后续操作规则、计费细节