Skip to content
上新MiniMax Speech 2.8 語音合成已上線:雙入口接入,官方牌價查看可用模型
HopBase
← 返回 Blog

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。綁定「Midjourney 生圖分組」的金鑰即刻可用。

怎麼呼叫

  • 非同步兩步：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 回傳為準。
  • 分組綁定：該模型放在「Midjourney 生圖分組」，綁定該分組的金鑰才呼叫得到，與可靈的金鑰不共用。
  • 提示詞必填：只傳參考圖不寫描述會被拒；參考圖最多 1 張，走 images 欄位。
  • 產物有效期：完成後 outputs 給出 4 條簽名直鏈，自任務完成起 6 小時有效，過期回傳 410，請在時限內下載。

價格：按官方口徑折算到每張

檔位觸發方式每張一次任務（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 條直鏈
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，官方已用新的編輯模型取代它們。

任務失敗會計費嗎？

不會。只有成功產出圖片的任務計費，失敗任務零費用。提示詞被內容審核攔截時會回傳明確的失敗原因，改寫後重試即可。

產品