想用 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):
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。POST /v1/images/edits— 可用 1–16 張參考圖進行編修;參考圖支援 JPG/PNG/WebP/HEIC/HEIF,單邊尺寸可為 128–8192 px。H3-Image-Context-IR— 提示詞擴寫步驟,不是圖像端點;用途是改寫簡短提示詞並選擇長寬比。
可直接貼上使用的請求格式(Global host):
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 Standard | 2K 範例 $0.023、4K 範例 $0.069;MiniMax 圖表中 4K 最快 |
| 對延遲敏感的批量需求(廣告、即時預覽) | H3-Image Highspeed | 1K 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 或提供第三方代管服務時,均需取得授權。