早鳥價(12 月 25 日截止),只要持續訂閱就一直鎖定:Go 每月 $10(原價 $20),Plus 用 Opus 5.5 每月只要 $30(原價 $50)立即訂閱 →

MiniMax H3-Image API:4K 成本、限制與 VRAM(2026)

想用 API 大量產出 4K 圖像,MiniMax H3-Image 的速度和帳面成本確實有吸引力。依 MiniMax 的延遲圖表,Highspeed 模式的 4096 × 4096 級輸出 P50 為 10.3 秒,Standard 為 16.0 秒。純文字生成 4K 時,Standard 的範例價格是 $0.06879,低於本文比較的第三方代管價格(WaveSpeed:1K/2K 每張 $0.03、4K 每張 $0.09);Highspeed 的 $0.13001 則較高。不過,若你的需求是多張參考圖下仍要穩定保留人物或產品身分,相關使用者回報建議另找方案。

4K 約 10 秒可出圖,但早期編修表現不如預期

H3-Image 是建構於 MiniMax H3 影片模型之上的新開放權重圖像模型,支援文字生成圖片、依參考圖生成,以及圖像編修。單次請求最多可帶入 16 張參考圖,並產生最多 10 張輸出。它提供 1K、2K、4K 三種目標面積,分別對應 1,048,576/4,194,304/16,777,216 像素;伺服器會依長寬比決定實際寬高,並在 data[].size 回傳。因此 4K 指的是目標面積,不一定是字面上的 4096×4096 正方形。

MiniMax 公布的 P50 延遲表現不錯,但其 4K 對照範圍有限。MiniMax 的 P50 延遲圖表顯示,Highspeed 文字生成圖片在 1K 為 7.7 秒、4K 為 10.3 秒;Standard 則是 10.6 秒與 16.0 秒。圖表中的 4K 僅與 Nano Banana 2.1(50–51 秒)比較,因此「比主流模型快 5 倍」的說法,基礎其實相當有限。

連結的 Reddit 討論中,留言者普遍認同 T2I 很快,但也反覆提到兩個問題:參考圖的人物相似度容易流失,以及宣稱高解析度的成品細節偏軟。

「可惜的是,若拿它當 ref2i 模型,它比實際的 H3 影片模型做 ref2i 差很多。」 — u/Omegapepper 於 r/StableDiffusion

「大家可能會對我不高興,但就我的測試結果,它在多參考圖編修方面明顯不如 QI 2.1 [...]。」 — u/Crazy-Repeat-2006 於 r/StableDiffusion

在連結的建議尺寸討論串裡,測試者指出本應銳利的輸出仍有低解析感、柔化與模糊問題,也質疑標示的高解析度是否真的帶來高頻細節。這些是初期使用者經驗,並非受控基準測試,但方向相當一致。

API 提供什麼:兩種模型、兩個圖像端點,加上一道擴寫提示詞流程

依 MiniMax API 文件,服務包含兩個模型 ID、兩個圖像端點,以及一個用於擴寫提示詞的步驟。

項目MiniMax-H3-Image(Standard)MiniMax-H3-Image-Highspeed
定位追求最低單張成本追求最低延遲
文字輸入$2.30 / 1M tokens$2.30 / 1M tokens
圖像輸入$1.50 / 1M tokens$3.00 / 1M tokens
圖像輸出$3.80 / 1M tokens$7.60 / 1M tokens

端點如下(以下為 Global host;中國帳戶請依同一份文件使用 China endpoint):

  1. POST https://api.minimax.io/v1/images/generations — 文字生成圖片;已確認參數包括 model、prompt(最長 32,000 字元)、disable_prompt_enhanced(預設 false)、n(1–10)、size(auto 或 WIDTHxHEIGHT)、aspect_ratio、area(1K/2K/4K,預設 4K)、output_format(預設 jpeg)、response_format(url/b64_json)、stream、output_compression。
  2. POST /v1/images/edits — 可用 1–16 張參考圖進行編修;參考圖支援 JPG/PNG/WebP/HEIC/HEIF,單邊尺寸可為 128–8192 px。
  3. H3-Image-Context-IR — 提示詞擴寫步驟,不是圖像端點;用途是改寫簡短提示詞並選擇長寬比。

可直接貼上使用的請求格式(Global host):

bash
curl https://api.minimax.io/v1/images/generations \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-H3-Image","prompt":"...","size":"auto","aspect_ratio":"16:9","area":"2K","disable_prompt_enhanced":false,"response_format":"url"}'

文件指出,請求不具冪等性,伺服器最長可能處理 600 秒;即使用戶端逾時或中斷連線,生成作業仍會繼續。已完成的圖像仍會計費,且只有成功生成的圖像會被計費,usage 統計的也是成功結果。若使用 OpenAI SDK,MiniMax 建議設定 max_retries=0。部分成功時會回傳 HTTP 200,並在各張圖的 data[].error 中附上錯誤資訊,包括內容安全失敗;因此必須逐項檢查。只有整批全部失敗時才會回傳 4xx/5xx。多數 4xx 應視為最終的設定錯誤;遇到狀態不明的逾時切勿直接重新 POST。若是非同步供應商,應輪詢既有工作,而不是再送出一筆新工作。

提示詞增強預設啟用。文字生成圖片可以關閉,編修則不能關閉;API 會在 data[].revised_prompt 回傳實際採用的改寫提示詞。開始調參前,先記錄它並與送出的提示詞比對。也要注意,關閉增強器後,模型大約只讀取前 4,096 tokens,而且必須指定精確尺寸或明確長寬比。

自行部署絕非 10 秒:權重、VRAM 與授權條款

權重已在 Hugging Face MiniMaxAI/MiniMax-H3-Image 與 GitHub MiniMax-AI/MiniMax-H3-Image 上線,提供 ComfyUI 轉換權重與 image_minimax_h3_image_t2i.json 工作流範本。模型卡列出這是一個 33.1B 參數的 diffusion transformer,BF16 checkpoint 為 68.65 GB,另有 66.7 GB 的 H3 文字編碼器;未計入可選的 17.9 GB 提示詞擴寫器前,總量就約為 135 GB。模型卡也將本機伺服器固定為 6 個推論步數、guidance scale 1,其他數值會回傳 HTTP 400,且不支援負面提示詞。

別期待用遊戲顯卡跑出 10 秒成績。ComfyUI 討論串裡有人詢問,即使用 4-bit 量化,模型是否能放進 5090。連結的開放權重討論中,一名 RTX 5090 使用者表示,以 INT8 跑 16 MP 約需 21 秒,畫面有顆粒感;改用 BF16 才能換得銳利度,但耗時更長。ComfyUI 討論串中另有一名 RTX 3070 Ti 使用者認為 16 MP 輸出的 T2I 很快,但參考圖編修沒有遵從提示詞。這只是單一使用者的觀察,不能證明激進量化適合參考圖工作。

對許多團隊而言,授權比 VRAM 更值得優先確認。模型卡採用日期為 2026 年 11 月 10 日的 MiniMax-H3-Image Community License Agreement:預設授權範圍不包括美國、歐盟、英國與大韓民國;年化營收超過 $1M,或向第三方提供代管服務時,必須事先取得書面授權;商業介面還必須顯示「MiniMax-H3-Image」。位於美國或歐盟的團隊,應在自行部署前先釐清授權。

1K、2K、4K 各要多少錢:MiniMax 範例試算

以下數字皆為 MiniMax 提供的成本範例,不是固定價格。實際計費按 token 計算,因此提示詞長度與參考圖數量都會影響總額。涉及參考圖的範例,均假設參考圖為 1K。

工作類型Standard 範例Highspeed 範例
T2I 1K 面積$0.02179$0.03529
T2I 2K 面積$0.02333$0.03622
T2I 4K 面積$0.06879 ($0.03439 promo)$0.13001 ($0.06501 promo)
編修 4K + 1 張參考圖$0.07312 ($0.03656 promo)$0.13673 ($0.06837 promo)
編修 4K + 3 張參考圖$0.07914 ($0.03957 promo)$0.15407 ($0.07703 promo)

有三點值得用來節省預算。第一,2K 的成本與 1K 幾乎相同,分別是 $0.02333 與 $0.02179,但目標像素數是 4 倍;若兩者皆符合需求,應優先選擇 2K。第二,4K 的像素數是 1K 的 16 倍,範例價格卻僅約為 3.2 倍;需要印刷細節時,原生 4K 效率不錯。第三,上市促銷會將符合條件的 4K Standard 價格減半至 $0.03439,期限至 2026 年 11 月 17 日 16:00 UTC,適用於至少 16,600,000 像素的輸出。

Highspeed 的圖像 token 費率大致翻倍,換取 3–7 秒的時間。在 4K T2I 中,價格為 $0.13001 對 $0.06879,也就是 1.89 倍。除非你是在延遲 SLO 下批量生成商品目錄圖,否則 Standard 較划算。每增加一張參考圖都會增加圖像輸入 token;因此在尚未考慮品質前,3 張參考圖的 4K 編修成本就比 1 張參考圖高約 8%。

該用 H3-Image,還是改選 Qwen、Krea 或 H3 video?

若工作負載是大量高解析度文字生成圖片,H3-Image 在 MiniMax 公布的價格與延遲範例中很有競爭力。但如果核心要求是身分一致性,在正式投入前應先測試以下替代方案。

使用情境建議選擇原因
大量 T2I 海報、背景、4K 風景H3-Image Standard2K 範例 $0.023、4K 範例 $0.069;MiniMax 圖表中 4K 最快
對延遲敏感的批量需求(廣告、即時預覽)H3-Image Highspeed1K 7.7 秒至 4K 10.3 秒;多付 1.9 倍價格,約省下 6 秒
多參考圖角色/產品一致性透過 Alibaba Cloud 使用 Qwen Image,或使用 H3 video ref2i連結討論串認為 H3-Image 的多參考圖編修弱於 QI 2.1;也有多名使用者持續使用 H3 video 做 ref2i
需要代管編修 UI,而非 API/自行部署Krea不必承擔約 135 GB 的本機資源需求;它是 UI 替代方案,不等同 API
在 24GB 或更少的顯存上自行部署等待 pruned/INT4 版本目前 BF16 需要資料中心等級的 VRAM

若人物或產品相似度至關重要,看似便宜的單張範例價格,很容易在反覆重試中失去意義。

正式上線前的檢查清單,避免花錢買到模糊成品

  • 先用 1K/2K 驗證:只將最終保留的圖放大到 4K;測試者回報預設 4K 偏軟,先在 2K 檢查銳利度。
  • 每次都記錄 revised_prompt:在變更任何設定前,先將它與原始送出的提示詞做差異比對。
  • 正確處理逾時與重試:用戶端逾時應設為超過 600 秒,因為伺服器最長可能需 600 秒;關閉 SDK 自動重試,只用用戶端去重鍵進行對帳;非同步供應商則輪詢工作,不要重新 POST。
  • 逐張處理批次錯誤:HTTP 200 的多輸出批次中仍可能有個別 data[].error;撰寫迴圈前,先查看編修 API 參考文件中的錯誤封裝格式。
  • 確認授權、response_format 與下載流程:依API 文件所述,url 回應不保證是持久儲存。

MiniMax H3-Image API 常見問題

MiniMax H3-Image 和 MiniMax H3 有何差異?

H3 是影片模型;H3-Image 是建立在其上的靜態圖像模型,用於文字生成圖片與 4K 級面積的編修。至於參考圖轉圖片的一致性,連結討論串中的多位使用者仍偏好 H3 video。

官方端點與模型 ID 是什麼?

使用 POST https://api.minimax.io/v1/images/generations,模型指定為 MiniMax-H3-Image 或 MiniMax-H3-Image-Highspeed;另有 /v1/images/edits,以及用於提示詞擴寫的 H3-Image-Context-IR。

我可以關閉提示詞增強嗎?

文字生成圖片可以,設定 disable_prompt_enhanced: true;編修則不行。API 會回傳實際使用的改寫提示詞。

能在消費級 GPU 本機執行 H3-Image 嗎?

可以,但需要量化與耐心:未含提示詞擴寫器時,BF16 約需 135 GB。模型卡的伺服器方案列出 H200、RTX PRO 6000 與 MI350X 級加速器。

它可以商業使用嗎?

必須先釐清 MiniMax-H3-Image Community License:預設授權不包括美國、歐盟、英國與韓國;營收超過 $1M 或提供第三方代管服務時,均需取得授權。