Midjourney v8.2 / Niji 7 图像生成 API
通过 APIMaster 异步调用 midjourney-v8.2 和 midjourney-niji-7。
Midjourney v8.2 / Niji 7 图像生成
使用 https://apimaster.ai/v1 的异步图像接口调用 midjourney-v8.2 或 midjourney-niji-7。模型版本由 model 决定,请勿在请求中额外传入版本覆盖字段。
提交任务
POST https://apimaster.ai/v1/midjourney/generations
curl -s "https://apimaster.ai/v1/midjourney/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "midjourney-v8.2",
"prompt": "a quiet Japanese garden at dawn, cinematic composition",
"size": "16:9",
"speed": "relax"
}'
请求体字段:
使用 Niji 7 时,将同一请求的 model 改为 midjourney-niji-7,例如:
{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 是 | midjourney-v8.2 或 midjourney-niji-7 |
prompt |
string | 是 | 图像描述;支持在末尾使用受支持的 Midjourney 参数 |
size |
string | 否 | 宽高比,如 1:1、16:9,默认 1:1 |
speed |
string | 否 | relax、fast 或 turbo,默认 relax |
image_urls |
string[] | 否 | 参考图 URL,可传 1–20 张;也支持合规的图片 Data URL |
iw |
number | 否 | 参考图权重 0–3,需同时提供 image_urls |
quality |
string | 否 | 0.25、0.5、1 或 2;Niji 7 不支持 |
stylize / chaos / weird |
integer | 否 | 分别为 0–1000、0–100、0–3000 |
seed |
integer | 否 | 随机种子 0–4294967295 |
negative_prompt |
string | 否 | 不希望出现在图像中的内容 |
sref / sw |
string / integer | 否 | 风格参考图公网 URL 与权重 0–1000;sw 需搭配 sref |
dref / dw |
string 或 string[] / number | 否 | 参考图 URL(最多 20 张)与权重 0–100;dw 需搭配 dref |
raw / tile / hd |
boolean | 否 | 原始风格、平铺与高清模式;tile 和 hd 仅支持 v8.2 |
extra |
string | 否 | 受支持的参数串,例如 --ar 16:9 --s 750;结构化字段优先 |
metadata |
object | 否 | 自定义业务元数据 |
repeat |
integer | 否 | 2–40,批量创建多个任务 |
Niji 7 不支持 quality、tile=true 和 hd=true。两款模型均不支持 draft=true、cref、cw、stop 以及请求中的 version、niji。style=raw 会按 raw=true 处理。提示词和 extra 中也不能使用 --v 或 --niji 覆盖模型版本。
提交响应包含批次 ID 和任务 ID:
{
"id": "imagine_batch_xxxxxxxx",
"request_id": "req_xxxxxxxx",
"model": "midjourney-v8.2",
"status": "queued",
"data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}
查询任务
使用批次 ID 或单个任务 ID 查询,任务只对创建它的账号可见:
curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
-H "Authorization: Bearer YOUR_API_KEY"
完成后,data 包含图片 URL,tasks 提供每个子任务的状态和进度:
{
"id": "imagine_batch_xxxxxxxx",
"status": "completed",
"progress": 100,
"data": [{"url": "https://example.com/generated.png"}],
"tasks": [{"task_id": "imagine_xxxxxxxx", "status": "completed", "progress": 100, "data": [{"url": "https://example.com/generated.png"}]}]
}
生成期间轮询 processing 或 queued 状态;失败时读取 tasks[].error,不要重复提交同一请求。图片 URL 可能有有效期,请在完成后及时下载。
若提交返回 502 且响应头包含 X-Task-ID,或查询返回 pending_timeout,表示提交结果仍在确认,请保存 ID 继续查询,避免自动重新提交。批次可能包含成功和失败的子任务,应检查 tasks[] 后逐个处理。建议每 15 秒查询一次。
错误与计费
model 和非空 prompt 是必填项。版本覆盖、无效比例、不可访问的参考图和不支持的参数会返回 400。401 表示密钥无效,402 表示余额不足,429 表示请求过于频繁。价格和可用路由请查看 Midjourney v8.2 模型卡与 Niji 7 模型卡。
