4K sınıfında görsel üretmek isteyenler için MiniMax H3-Image, MiniMax'ın verilerine göre dikkat çekici bir hız sunuyor: Highspeed modunda P50 gecikme 10,3 saniye, Standard modunda ise 16,0 saniye. Düz metinden 4K görsel üretiminde Standard'ın örnek maliyeti $0.06879 ile bu yazıdaki üçüncü taraf barındırılan seçeneğin altında kalıyor (WaveSpeed: 1K/2K için görsel başına $0.03, 4K için $0.09). Highspeed ise $0.13001 ile daha pahalı. Buna karşılık, çoklu referansla kimlik tutarlılığının kritik olduğu düzenlemelerde bağlantılı kullanıcı yorumları başka seçeneklere bakılmasını öneriyor.
4K üretim yaklaşık 10 saniye sürüyor; ilk düzenleme deneyimleri ise zayıf
MiniMax H3 video altyapısı üzerine kurulan yeni açık ağırlıklı görüntü modeli H3-Image; metinden görsel üretim, referans tabanlı üretim ve düzenleme işlerini yapabiliyor. İstek başına en fazla 16 referans görseli ve 10 çıktı destekliyor. 1K/2K/4K alan seviyeleri sırasıyla 1.048.576 / 4.194.304 / 16.777.216 pikseli hedefliyor. Sunucu kesin genişlik ve yüksekliği en-boy oranına göre belirleyip data[].size içinde döndürüyor. Dolayısıyla 4K, her zaman tam olarak 4096×4096 kare anlamına gelmiyor; hedeflenen piksel alanını ifade ediyor.
MiniMax'ın P50 gecikme değerleri güçlü görünüyor, ancak 4K karşılaştırmasının kapsamı dar. MiniMax'ın P50 gecikme grafiği, Highspeed metinden görsel üretimde 1K için 7,7 saniye, 4K için 10,3 saniye; Standard içinse sırasıyla 10,6 ve 16,0 saniye veriyor. 4K tarafında grafikte yalnızca Nano Banana 2.1 ile karşılaştırma var; onun süresi 50–51 saniye. Bu nedenle “ana akım çözümlerden 5 kat hızlı” iddiası sınırlı bir karşılaştırmaya dayanıyor.
Bağlantılı Reddit başlıklarındaki yorumcular T2I hızını doğruluyor; fakat iki ortak eksik öne çıkıyor: referanslardaki benzerliğin kaybolması ve iddia edilen yüksek çözünürlükte ayrıntıların yumuşak kalması.
"Maalesef ref2i modeli olarak, ref2i için asıl H3 video modeline kıyasla çok kötü." — r/StableDiffusion üzerinde u/Omegapepper
"İnsanlar bana kızabilir ama test ettiklerime göre, çoklu referanslı düzenleme konusunda QI 2.1'den belirgin biçimde daha düşük." — r/StableDiffusion üzerinde u/Crazy-Repeat-2006
Bağlantılı önerilen boyutlar başlığında test edenler, keskin olması beklenen çıktılarda düşük çözünürlük hissi, yumuşaklık ve bulanıklık tarif ediyor. Ayrıca iddia edilen yüksek çözünürlüğün gerçekten yüksek frekanslı ayrıntı taşıyıp taşımadığı tartışılıyor. Bunlar kontrollü kıyaslamalar değil, erken dönem anekdotlar; yine de işaret ettikleri yön aynı.
API'nin sundukları: iki model, iki görsel uç noktası ve genişletilmiş istem
MiniMax API dokümanlarında iki model kimliği, iki görsel uç noktası ve istem genişletme için ek bir adım bulunuyor.
| Öğe | MiniMax-H3-Image (Standard) | MiniMax-H3-Image-Highspeed |
|---|---|---|
| Hedef | Görsel başına en düşük maliyet | En düşük gecikme |
| Metin girdisi | $2.30 / 1M token | $2.30 / 1M token |
| Görsel girdisi | $1.50 / 1M token | $3.00 / 1M token |
| Görsel çıktısı | $3.80 / 1M token | $7.60 / 1M token |
Uç noktalar aşağıda yer alıyor. Buradaki adres Global host içindir; Çin hesapları aynı dokümanlarda belirtilen Çin uç noktasını kullanır:
POST https://api.minimax.io/v1/images/generations— metinden görsel üretimi. Doğrulanan parametreler:model,prompt(en fazla 32.000 karakter),disable_prompt_enhanced(varsayılan false),n(1–10),size(autoveyaWIDTHxHEIGHT),aspect_ratio,area(1K/2K/4K, varsayılan4K),output_format(varsayılan jpeg),response_format(url/b64_json),stream,output_compression.POST /v1/images/edits— 1–16 referansla düzenleme. Referans olarak JPG/PNG/WebP/HEIC/HEIF kabul ediliyor; her kenar 128–8192 px olabiliyor.H3-Image-Context-IR— kısa istemi yeniden yazıp en-boy oranı seçen, görsel uç noktası olmayan istem genişletme adımı.
Kopyalayıp yapıştırılabilecek istek yapısı şöyle (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"}'Dokümanlara göre istekler idempotent değil. Sunucunun işlemi 600 saniyeye kadar sürebiliyor; istemci zaman aşımına uğrasa veya bağlantı kesse bile üretim devam ediyor. Tamamlanan görsel yine ücretlendiriliyor ve yalnızca başarılı görseller faturalandırılıyor; usage başarılı sonuçları sayıyor. MiniMax, OpenAI SDK ile max_retries=0 kullanılmasını öneriyor. Kısmi başarı durumunda HTTP 200 döner; her görsel için içerik güvenliği hataları dahil data[].error alanlarını incelemek gerekir. Yalnızca tüm görseller başarısız olursa 4xx/5xx alınır. Çoğu 4xx hatasını kalıcı yapılandırma hatası sayın, belirsiz zaman aşımlarında isteği yeniden göndermeyin ve asenkron sağlayıcılarda yeni iş açmak yerine mevcut işi sorgulayın.
İstem iyileştirme varsayılan olarak açık. Metinden görsel üretimde kapatılabiliyor, düzenleme isteklerinde ise kapatılamıyor. API, yeniden yazılan istemi data[].revised_prompt içinde döndürüyor. Başka bir ayar kurcalamadan önce bunu kaydedip gönderdiğiniz istemle karşılaştırın. İyileştiricinin kapalı olduğu durumda model yaklaşık ilk 4.096 tokenı okuyor; ayrıca kesin bir boyut ya da açıkça belirtilmiş bir en-boy oranı vermeniz gerekiyor.
Yerelde çalıştırmak 10 saniyelik iş değil: ağırlıklar, VRAM ve lisans
Ağırlıklar Hugging Face MiniMaxAI/MiniMax-H3-Image ve GitHub MiniMax-AI/MiniMax-H3-Image üzerinde erişime açık. ComfyUI için dönüştürülmüş ağırlıklar ve image_minimax_h3_image_t2i.json iş akışı şablonu da var. Model kartı, 33,1 milyar parametreli bir diffusion transformer, 68,65 GB BF16 kontrol noktası ve ayrı bir 66,7 GB H3 metin kodlayıcısı listeliyor. İsteğe bağlı 17,9 GB'lık istem genişletici hesaba katılmadan önce bile toplam yaklaşık 135 GB ediyor. Kart, yerel sunucuyu 6 çıkarım adımına ve guidance scale 1 değerine sabitliyor; farklı değerler burada HTTP 400 döndürüyor. Negatif istem desteği de yok.
Oyuncu ekran kartında 10 saniyelik üretim planlamayın. ComfyUI başlıklarında modelin 4-bit quantization ile bile 5090'a sığıp sığmayacağı soruluyor. Bağlantılı açık ağırlıklar başlığında bir RTX 5090 kullanıcısı, INT8 ile 16 MP için yaklaşık 21 saniye gördüğünü; çıktının grenli kaldığını ve keskinlik için daha uzun sürede BF16 gerektiğini bildiriyor. ComfyUI başlığındaki bir RTX 3070 Ti kullanıcısı, 16 MP çıktıda T2I'ı hızlı buluyor ancak referans düzenlemenin istemi görmezden geldiğini söylüyor. Bu tek kullanıcı verisi; agresif quantization'ın referans işleri için güvenli olduğunun kanıtı değil.
Birçok ekip için lisans, VRAM'den daha önemli bir engel olabilir. Model kartında 10 Kasım 2026 tarihli MiniMax-H3-Image Community License Agreement kullanılıyor. Varsayılan lisans izni Amerika Birleşik Devletleri, Avrupa Birliği, Birleşik Krallık ve Kore Cumhuriyeti'ni kapsamıyor; yıllıklandırılmış geliri $1M'nin üzerindeki kullanımlar veya üçüncü taraflara sunulan barındırılan hizmetler için önceden yazılı yetki istiyor. Ticari arayüzlerde ayrıca "MiniMax-H3-Image" ibaresinin gösterilmesi gerekiyor. ABD veya AB merkezli ekipler, yerelde barındırmadan önce lisansı netleştirmeli.
1K, 2K ve 4K görsel maliyeti: MiniMax'ın örnek hesabı
Aşağıdaki rakamların tamamı MiniMax tarafından verilen örnek maliyetlerdir; sabit fiyat değildir. Faturalandırma token tabanlı olduğundan istem uzunluğu ve referans sayısı toplamı değiştirir. Referans içeren örneklerde 1K referans görseller varsayılıyor.
| İşlem | Standard örneği | Highspeed örneği |
|---|---|---|
| T2I 1K alan | $0.02179 | $0.03529 |
| T2I 2K alan | $0.02333 | $0.03622 |
| T2I 4K alan | $0.06879 ($0.03439 promosyon) | $0.13001 ($0.06501 promosyon) |
| 4K düzenleme + 1 referans | $0.07312 ($0.03656 promosyon) | $0.13673 ($0.06837 promosyon) |
| 4K düzenleme + 3 referans | $0.07914 ($0.03957 promosyon) | $0.15407 ($0.07703 promosyon) |
Maliyeti azaltan üç önemli nokta var. İlki, 2K'nın 1K'ya göre neredeyse aynı maliyete sahip olması: hedef piksel sayısı 4 katına çıkarken fiyat $0.02333 yerine $0.02179. Her ikisinin de iş göreceği senaryolarda 1K yerine 2K seçin. İkincisi, 4K 1K'nın 16 katı piksel taşımasına rağmen örnek fiyatı yaklaşık 3,2 kat daha yüksek; baskı ayrıntısı gerektiğinde yerel 4K verimli. Üçüncüsü, lansman promosyonu en az 16.600.000 piksel çıktılar için uygun 4K Standard fiyatını 17 Kasım 2026, 16:00 UTC'ye kadar yarıya indirerek $0.03439'a çekiyor.
Highspeed, 3–7 saniye kazanmak için görsel token ücretlerini yaklaşık ikiye katlıyor. 4K T2I'da fiyat $0.06879 yerine $0.13001; yani 1,89 kat. Gecikme SLO'suna bağlı katalog render'larını toplu üretmiyorsanız Standard daha mantıklı. Her ek referans görsel girdisi tokenı ekler; kaliteyi hesaba katmadan önce bile 3 referanslı 4K düzenleme, 1 referanslı sürümden yaklaşık %8 daha pahalıdır.
API çağrısı H3-Image'a mı, Qwen'e mi, Krea'ya mı yoksa H3 video'ya mı gitmeli?
Yüksek çözünürlükte toplu metinden görsel üretimi yapıyorsanız, MiniMax'ın yayımladığı fiyat ve gecikme örneklerinde H3-Image cazip görünüyor. İşiniz kimlik tutarlılığına dayanıyorsa karar vermeden önce aşağıdaki alternatifleri kıyaslayın.
| Kullanım senaryosu | Tercih | Neden |
|---|---|---|
| Toplu T2I afiş, arka plan ve 4K manzara | H3-Image Standard | 2K için $0.023, 4K için $0.069 örnek maliyet; MiniMax grafiğinde en hızlı 4K |
| Gecikmeye duyarlı toplu işler (reklamlar, canlı önizlemeler) | H3-Image Highspeed | 1K'da 7,7 sn'den 4K'da 10,3 sn'ye; yaklaşık 6 sn kazanmak için 1,9 kat ödeme |
| Çoklu referansta karakter / ürün tutarlılığı | Qwen Image üzerinden Alibaba Cloud veya H3 video ref2i | Bağlantılı başlıklarda H3-Image'ın çoklu referans düzenlemelerinde QI 2.1'den zayıf olduğu bildiriliyor; bazı kullanıcılar ref2i için H3 video kullanmayı sürdürüyor |
| API/yerel barındırma yerine yönetilen düzenleme arayüzü | Krea | Yerelde yaklaşık 135 GB alan gerektirmez; API karşılığı değil, arayüz tabanlı bir alternatif |
| 24GB veya daha düşük VRAM'de yerel çalıştırma | Budanmış/INT4 sürümlerini bekleyin | BF16 bugün veri merkezi sınıfı VRAM gerektiriyor |
Benzerliğin önemli olduğu işlerde, görsel başına düşük görünen fiyat yeniden denemelerde hızla anlamını yitirir.
Bulanık sonuçlara ve gereksiz faturalara karşı yayın kontrol listesi
- 1K/2K hazır ayarlarıyla başlayın; yalnızca seçtiğiniz çıktıları 4K'ya taşıyın. Test edenler varsayılan 4K'da yumuşaklık bildirdiğinden, önce 2K'da keskinliği doğrulayın.
- Her çalıştırmada
revised_promptdeğerini kaydedin; başka bir şeyi değiştirmeden önce gönderdiğiniz istemle farkını inceleyin. - İstemci zaman aşımlarını 600 saniyenin üzerine ayarlayın; sunucu 600 saniyeye kadar sürebilir. SDK otomatik yeniden denemelerini kapatın, yalnızca mutabakat için istemci tarafında bir tekrar engelleme anahtarı tutun ve asenkron sağlayıcılarda yeniden POST atmak yerine işi sorgulayın.
- HTTP 200 dönen çoklu çıktı paketlerinde görsel bazındaki
data[].errorkayıtlarını işleyin. Döngüyü yazmadan önce hata zarfı için edits referansını kontrol edin. - Lisansı,
response_formattercihini ve istem indirmelerini doğrulayın. API dokümanlarına göreurlyanıtları kalıcı depolama garantisi vermiyor.
MiniMax H3-Image API: sık sorulan sorular
MiniMax H3-Image ile MiniMax H3 arasındaki fark nedir?
H3 video modelidir; H3-Image ise bunun üzerine inşa edilmiş, 4K sınıfı alanlarda metinden görsel üretim ve düzenleme için tasarlanmış sabit görsel modelidir. Bağlantılı başlıklardaki bazı kullanıcılar, referanstan görsele tutarlılıkta hâlâ H3 video'yu tercih ediyor.
Resmî uç nokta ve model kimliği nedir?
POST https://api.minimax.io/v1/images/generations uç noktasında model: MiniMax-H3-Image veya MiniMax-H3-Image-Highspeed kullanılır. Düzenleme için /v1/images/edits, istem genişletme için de H3-Image-Context-IR bulunur.
İstem iyileştirmeyi kapatabilir miyim?
Metinden görsel üretimde evet: disable_prompt_enhanced: true. Düzenlemede ise hayır. API, kullandığı yeniden yazılmış istemi geri döndürür.
H3-Image'ı tüketici GPU'sunda yerelde çalıştırabilir miyim?
Ancak quantization ve sabırla: istem genişletici öncesinde BF16 için yaklaşık 135 GB gerekiyor. Model kartı sunucu tariflerinde H200, RTX PRO 6000 ve MI350X sınıfı hızlandırıcıları anıyor.
Ticari kullanım mümkün mü?
Yalnızca MiniMax-H3-Image Community License koşullarını netleştirdikten sonra. Varsayılan izin ABD, AB, Birleşik Krallık ve Kore'yi kapsamıyor; $1M üzeri gelir veya üçüncü taraflara sunulan barındırılan hizmetler için yetki gerekiyor.