MiniMax H3 Image API: Üretim, Düzenleme ve Gerçek Fiyatlandırma

Aynı model için sağlayıcı fiyatları: Cheap MiniMax H3 Image API · 2026-11-13

MiniMax H3 Image yetenekleri ve barındırılan API sınırları

H3 Image'i değerlendirmenin en güçlü nedeni, birleşik üretim ve düzenleme iş akışıdır: yeni bir varlığı tanımlayın, ürün veya karakter referansları sağlayın, ardından hedefli bir değişiklik isteyin. MiniMax ayrıca yerel dağıtım için ağırlıkları yayımlar. Yayımlanan yetenek iddiaları, her çıktıda tam logolar, tipografi veya kimlik koruması garantisi değildir.

Barındırılan API özelliği	Belgelenen sözleşme
Üretim	POST /v1/images/generations
Düzenleme	POST /v1/images/edits, 1–16 referans görsel
İstem	32.000 karaktere kadar; iyileştirme olmadan yalnızca ilk yaklaşık 4.096 token etkili olur
Çıktı boyutları	655.360–20.000.000 piksel; en-boy oranı 1:3 ile 3:1 arasında
Çıktı sayısı	n 1 ile 10 arasında
Biçimler	Varsayılan olarak JPEG; PNG veya WebP desteklenir
Yanıtlar	URL veya akışsız Base64; yerel SSE desteklenir
Desteklenmeyen kontroller	Maskeli düzenleme, saydam arka planlar ve önizleme görselleri

Referans dosyaları MiniMax'in giriş sınırlarına uymalıdır: JPG/JPEG, PNG, WebP, HEIC veya HEIF, her boyut 128–8.192 piksel, uzun kenarın kısa kenara oranı en fazla 4:1 ve toplam istek gövdesi en fazla 64 MiB. Base64 istek boyutunu artırır. Erişilebilir görsel URL'leri veya uygun boyutta yüklemeler kullanın; modelin 16 görseli kabul edebilmesi, gövde boyutu sınırını ortadan kaldırmaz.

“4K” bu API'de bir alan ayarıdır. area: "4K" yaklaşık 4096 × 4096 pikseli hedefler; boyutlar en-boy oranından türetilir. 16:9'da belgelenen çıktı 5472 × 3072'dir, 4096 × 2304 değil. Açık boyutlar için size: "WIDTHxHEIGHT" gönderin ve area ile aspect_ratio alanlarını atlayın. Alana dayalı boyutlandırma için size: "auto", area ve aspect_ratio kullanın. data[].size alanını ve indirilen görselin gerçek boyutlarını kontrol edin.

MiniMax H3 Image maliyeti nedir?

Güncel APIMaster Standard rotası için normal fiyat hesaplaması şöyledir:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Metin ve görsel kullanım alanlarını ayrı ayrı kullanın; tüm giriş tokenlarını metin olarak ücretlendirip ardından görsel girişini yeniden eklemeyin. İstem iyileştirme, faturalandırılan metin tokenlarına katkıda bulunur; bu nedenle toplam fiyatı yalnızca çözünürlük belirlemez. Geçerli olduğunda hesaba özgü katsayılar ve faturalandırma yuvarlaması nihai borcu etkileyebilir.

MiniMax'in resmî örnek Standard toplamları faturanın ölçeğini gösterir. Bunlar örnektir; APIMaster sabit tarifeleri veya ölçtüğümüz ortalama değildir:

Görev	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, normal ücret
Metinden görsele	$0.02179	$0.02333	$0.06879
Bir adet 1K referansla düzenleme	$0.02654	$0.02658	$0.07312
Üç adet 1K referansla düzenleme	$0.03563	$0.04177	$0.07914

Örnek olarak, ilk örnekte 1.000 metinden görsele istek yaklaşık $21.79 tutar; bu, ön ödemeli paket değil, örnek bir token bütçesi hesaplamasıdır. Gerçek istemler ve iyileştirme bunu değiştirebilir. Nano Banana 2.1 farklı, çözünürlüğe dayalı bir APIMaster sözleşmesine sahiptir ve ayrı olarak belirtilecek koşullar öncesinde 1.000 adet 1K görsel için $15.12'den başlar.

Resmî %50 4K promosyonu APIMaster'da geçerli mi?

Geçerli olduğunu varsaymayın. MiniMax, Standard ve Highspeed için toplam istek maliyetinde %50 indirimi, 17 Kasım 2026, 16:00 UTC'ye kadar (hariç)—Pekin saatiyle 18 Kasım 00:00—teslim edilen nihai görselin en az 16.600.000 piksele sahip olması koşuluyla duyuruyor. Kare 4K metinden görsele örneği bu teklif sırasında $0.06879'dan $0.03439'a düşer.

4096 × 4096 çıktı alan itibarıyla uygundur; 4096 × 2304 uygun değildir. Tek başına “4K” etiketi yeterli değildir. Güncel APIMaster genel rotası, bu geçici promosyon olmadan normal token ücretlerini kullanır. MiniMax'in kampanya başlığını değil, gerçek ödeme/kullanım sözleşmesini karşılaştırın. Son tarihten sonra promosyon örnekleri güncel fiyat olarak kullanılmamalıdır.

MiniMax H3 Image API örneği: metinden görsele

APIMaster hesabı oluşturun, ücretli görsel istekleri için bakiye ekleyin, ardından API anahtarları bölümünde bir anahtar oluşturun. Ortamınızda APIMASTER_API_KEY değişkenini ayarlayın. Bu örnek, Standard rotasının büyük/küçük harfe duyarlı tam model kimliğini kullanır:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Bu bir istek örneğidir, görsel kalitesi kıyaslaması değildir. Başarılı çıktı URL'lerini hemen indirin ve dosyaları kendiniz saklayın. Görsel başına hataları kontrol edin: n > 1 olduğunda HTTP 200, başarısız görseller içerebilir. Zaman aşımı, isteğin reddedildiğini kanıtlamaz. H3 üretimi idempotent değildir; bu nedenle otomatik bir yeniden deneme başka bir ücretli üretim oluşturabilir. OpenAI SDK kullanıyorsanız yeterince uzun bir zaman aşımı ve max_retries=0 ayarlayın.

MiniMax H3 Image düzenleme: referans görseller ve istem kontrolü

JSON düzenleme için referans URL'lerini images[].image_url alanına gönderin. Nano Banana'nın image_urls alanını bu H3 isteğine kopyalamayın. Örnek URL'leri erişilebilir kendi varlıklarınızla değiştirin:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

APIMaster'ın mevcut 11 Kasım entegrasyon kabul kontrolleri HTTP referanslarını, veri URI'lerini, çok parçalı yüklemeleri, çok referanslı düzenlemeyi, SSE'yi ve 1K/2K/4K kod çözümü yapılmış çıktıları kapsıyordu. Kontrollü iki referanslı test, dört renkli şekli ve iki kısa etiketi korudu. Bunlar basit varlıklarla yapılan arayüz ve faturalandırma kontrolleriydi, kapsamlı bir fotoğrafçılık veya tipografi değerlendirmesi değildi; başka bir modele üstünlük sağladığını göstermezler.

Üretim varsayılan olarak istem iyileştirmeyi kullanır; sabit boyutlar veya sabit bir en-boy oranı sağlarken bunu disable_prompt_enhanced: true ile devre dışı bırakabilirsiniz. Düzenlemeler her zaman iyileştirme kullanır. Beklenmeyen değişiklikleri teşhis ederken revised_prompt alanını inceleyin. Ürün çalışmalarında nelerin sabit kalması gerektiğini belirtin, her referansın rolünü tanımlayın ve yayımlamadan önce işlenmiş etiketi doğrulayın.

Standard ile Highspeed, açık ağırlıklar ile barındırılan API

Highspeed aynı belgelenen API parametrelerini kullanır, ancak resmî görsel girişi ve görsel çıkışı ücretleri Standard'ın iki katıdır; metin girişi $2.30/M olarak kalır. APIMaster şu anda yalnızca Standard'ı listeliyor. MiniMax'in lansman hız iddiaları model varyantına, boyuta ve dağıtıma bağlıdır ve ölçülmüş bir APIMaster gecikme garantisi değildir.

Resmî Hugging Face deposu, Diffusers, SGLang, vLLM-Omni ve ComfyUI dahil olmak üzere ağırlıklar ve entegrasyonlar sağlar. BF16 kontrol noktası yaklaşık 68,65 GB'tır ve ayrı bir yaklaşık 66,7 GB metin kodlayıcı vardır. İndirme boyutu tam bir GPU bellek tahmini değildir. Yerel ağırlıklar MiniMax H3 Image topluluk lisansını kullanır; bu nedenle dağıtımdan önce bu lisansı inceleyin; “açık ağırlıklar”, MIT veya Apache altında kısıtlamasız kullanım anlamına gelmez.

İstemleri çıkarım altyapısı kurmadan değerlendirmek için barındırılan erişimi kullanın. Çıkarım üzerindeki kontrol, GPU, bakım ve lisanslama işlerini haklı çıkarıyorsa yerel dağıtımı düşünün. Yerel pipeline sınırları ile barındırılan API sınırları farklı sözleşmelerdir.

FAQ

MiniMax H3 Image, MiniMax H3 video ile aynı mı?

Hayır. H3 Image, MiniMax-H3-Image kullanarak durağan görseller üretir ve düzenler. H3 video ailesinin model kimlikleri, uç noktaları ve faturalandırması farklıdır. Ayrı MiniMax H3 video rehberine bakın.

MiniMax H3 Image APIMaster'da kullanılabilir mi?

Evet. 13 Kasım kontrolünde, $2.30/M metin girişi, $1.50/M görsel girişi ve $3.80/M görsel çıkışı üzerinden faturalandırılan, etkin bir genel Standard rotası bulundu. Highspeed'in genel rotası yoktu. İstek göndermeden önce canlı model kartını kontrol edin.

H3 Image görsel başına sabit $0.02 olan bir API mi?

Hayır. Resmî görsel başına örnekler örnek toplamlardır. Faturayı gerçek token kullanımı, istem iyileştirme, referans girişleri ve çıktı boyutları belirler. Güncel APIMaster rotası normal token formülünü kullanır.

H3 Image 16 referansla veya maskeyle düzenleme yapabilir mi?

Biçim ve istek boyutu sınırları dahilinde 16 referans görsele kadar belgelenmiştir. Maskeli düzenleme ve saydam arka planlar desteklenmez. Referansa dayalı talimatlar piksel düzeyinde birebir koruma garantisi vermez.

Hangisi daha ucuz: H3 Image mi Nano Banana 2.1 mi?

Örneklenen 1K metinden görsele görevinde H3'ün normal resmî örneği $0.02179 iken APIMaster Nano Banana 2.1, 1K görsel başına $0.01512'den başlar. Bu, örnek bir token toplamını çözünürlük teklifiyle karşılaştırır; istemleriniz için gerçek kabul edilen çıktı maliyetini ölçün. Özel karşılaştırmaya bakın.

Kaynaklar ve sonraki adımlar

13 Kasım 2026'da kontrol edilen kaynaklar: MiniMax sürümü, barındırılan API kılavuzu, resmî fiyatlandırma ve promosyon, model ağırlıkları ve lisansı, Google görsel fiyatlandırması ve APIMaster canlı pazaryeri kartları. Yetenek açıklamaları ilgili sağlayıcılardan gelir; fiyat kontrolleri ve tarihli APIMaster entegrasyon gözlemleri ayrı olarak belirtilmiştir.

H3 Image kartını açın, kaydolun, bir API anahtarı oluşturun ve MiniMax-H3-Image modelini https://apimaster.ai/v1 adresine gönderin. Farklı bir faturalandırma sözleşmesine sahip indirimli bir alternatif için Nano Banana 2.1 rotalarını karşılaştırın; şu anda Google'ın görsel çıktı referansına göre %55'e kadar düşüktür.