跳到正文
上新GPT Image 2.6 Flare / Sunburst 已上线：支持动图 GIF、矢量 SVG，官方价 7.5 折查看模型
HopBase
← 返回博客

Midjourney v8.2 API 接入：一次四张，1K 每张 $0.0067

HopBase 2026年09月21日 6 分钟阅读
Midjourney v8.2 API 接入：一次四张，1K 每张 $0.0067

Midjourney v8.2（模型 ID midjourney-v8-2）已经上线 HopBase，走 OpenAI 兼容的 POST /v1/images/generations 提交、GET /v1/video/tasks/{task_id} 轮询取结果。它和多数生图模型最大的不同是一次任务固定出 4 张候选图，画幅与画质写在提示词里（--ar 定比例、--hd 出原生 2K），而不是靠请求字段。计费按实际回源张数，1K 每张 $0.0067、2K 每张 $0.0108。用 GET /v1/models 确认你的密钥可调即可开始。

怎么调用

  • 异步两步：POST /v1/images/generations 返回 202 与任务 ID，再轮询 GET /v1/video/tasks/{task_id}；状态走 queued → processing → completed，只有 completed 与 failed 是终态。
  • 模型 ID 写全：midjourney-v8-2。完整 ID 以 GET /v1/models 返回为准。
  • 提示词必填：只传参考图不写描述会被拒；参考图最多 1 张，走 images 字段。
  • 产物有效期：完成后 outputs 给出 4 条签名直链，自任务完成起 24 小时有效；再次轮询返回同一组链接、不会续期，过期返回 410，请在窗口内下载。
  • 超时不扣费：创建后 2 小时仍未完成的任务判为失败、不计费。
  • 单任务实扣：任务终态后查询结果带 usage.cost_usd，即这一单的实际扣费，可在代码里逐单对账。

价格：按官方口径折算到每张

档位触发方式每张一次任务（4 张）
常规默认$0.0067$0.0267
2K提示词加 --hd$0.0108$0.0433

Midjourney 官方按 GPU 时间计价（一次常规任务 0.8 GPU 分钟、--hd 1.3 分钟），我们按官方口径折算成每张单价接入。计费按实际回源的张数，所以一次调用是四张的钱——这一点请写进你的预算模型，不要按「一张多少钱」去估。作为对照，目录里单张出图的模型一次调用大多在 $0.029～$0.067 之间，Midjourney 一次拿四张总价仍低于其中多数。实际单价以你所在分组为准，控制台按请求给出分项成本。

画幅与尺寸

尺寸不是请求字段，由提示词里的 --ar 决定；加 --hd 出原生 2K。以下为实测值：

--ar常规加 --hd
1:1（默认）1024 × 10242048 × 2048
16:91456 × 8162944 × 1648
9:16816 × 14561648 × 2944
4:31232 × 9282544 × 1904
21:91680 × 7203376 × 1440

--ar 只接受整数比，--ar 1.5:1 会被拒；比例上限 14:1，开 --hd 后收紧到 4:1。

参数支持情况

  • 可用：--ar、--hd、--s（0-1000）、--c（0-100）、--weird（0-3000）、--iw（0-3）、--sref 与 --sw、--no、--seed、--tile、--exp。
  • v8.2 不支持、提交即返回 400：--q/--quality、--niji、--repeat、--oref、--cref、--stealth、--stop、--draft，以及 :: 多提示词加权。

这批参数我们在提交阶段就拒而不是转发：其中一部分模型会静默忽略（你付了钱却没拿到效果），另一部分要等几十秒任务跑完才失败。错误信息会写明是哪个参数、为什么不支持。

三分钟接入

# 1. 提交，返回 202 + 任务 ID
curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"midjourney-v8-2","prompt":"a red apple on a wooden table, studio light --ar 16:9"}'

# 2. 用上一步的 id 轮询，completed 后取 outputs 里的 4 条直链(24 小时有效)
curl https://api.hop-base.com/v1/video/tasks/你的任务ID \
  -H "Authorization: Bearer sk-你的密钥"

常见问题

能不能只生成一张？

不能。Midjourney 所有生成模式都固定输出 2×2 共四张候选图，这是模型本身的设计，不是接入方的限制。请求里的张数字段与 --repeat 都不会改变这个结果，我们因此不接受 n 为 4 以外的值——与其静默按四张收费，不如在提交时讲清楚。

怎么控制尺寸？

写在提示词里：--ar 决定比例，--hd 出原生 2K。请求体的 quality 字段对该模型无效，传了会被拒。完整尺寸对照见上表。

支持参考图吗？

支持，最多 1 张，走 images 字段，可用 --iw（0-3）调参考强度；风格参考用 --sref 配 --sw。需要注意 v8.2 不支持 --oref 与 --cref，官方已用新的编辑模型取代它们。

任务失败会计费吗？

不会。只有成功产出图片的任务计费，失败任务零费用。提示词被内容审核拦截时会返回明确的失败原因，改写后重试即可。

产品