APIMaster.ai

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 模型卡。