MiniMax H3-Image Nedir?

MiniMax H3-Image, MiniMax tarafından 10 Kasım 2026'da yayımlanan, yükseltici (upscaler) olmadan yaklaşık 16 megapiksel (4096 x 4096) boyutunda görsel üretebilen ve düzenleyebilen açık ağırlıklı bir görüntü modelidir. MiniMax'e göre 4K bir görsel yaklaşık 10 saniye sürüyor. Modeli MiniMax API üzerinden çağırabilir, Hailuo AI ve MiniMax Code içinde kullanabilir veya ağırlıkları Hugging Face'ten indirebilirsiniz.

Bu rehber; MiniMax H3-Image'in ne olduğunu, MiniMax'in gerçekte ne iddia ettiğini, "açık ağırlıklı" ifadesinin lisansı altında ne anlama geldiğini, lansman haftası indirimi sırasında ne kadar maliyetli olduğunu ve kodlama ajanınızdan API'yi nasıl test edeceğinizi açıklıyor.

MiniMax H3-Image nedir?

MiniMax H3-Image, MiniMax H3 ailesine ait bir metinden görüntüye ve görüntü düzenleme modelidir. Tek bir kontrol noktası (checkpoint) her iki işi de üstlenir: bir istemden (prompt) görsel oluşturur ve 16 referans görsele kadar düzenleme yapabilir. 4096 x 4096 (1:1) boyutundan 6272 x 2688'e (21:9) kadar herhangi bir en-boy oranında yaklaşık 16 megapiksel çıktı üretir ve ağırlıkları topluluk lisansı altında yayımlanmıştır.

MiniMax'in X üzerindeki lansman gönderisinde vaat kısa: "10 saniyede 4K görsel üretimi", 16 milyon piksel, gerçekçilik, istemleri hassas takip etme ve düzenleme, 16 referans görsele kadar destek ve açık ağırlıklar.

H3-Image, MiniMax M3 rehberinde ele alınan MiniMax'in kodlama modelinden ayrıdır ve kendi API uç noktalarına sahiptir.

MiniMax, H3-Image hakkında ne iddia ediyor?

Aşağıda MiniMax'in Hugging Face model kartında ve duyurusunda yayımladıkları yer alıyor. Hız ve kalite ifadelerini MiniMax'in iddiaları olarak değerlendirin; bu yazı yazıldığında şirket dışında kimsenin bağımsız ölçüm yayımlamamıştı.

İddia	MiniMax ne diyor	Kaynak
Çözünürlük	Yaklaşık 16 MP, 1:1'de 4096 x 4096, 21:9'da 6272 x 2688'e kadar, yükseltici olmadan	Model kartı
Hız	Yaklaşık 10 saniyede 4K görsel	Lansman gönderisi
Örnekleme	6 örnekleme adımına damıtılmış, classifier-free guidance yok	Model kartı
Referanslar	Düzenleme başına 16 referans görsele kadar	Model kartı, API rehberi
Yönergeleri takip	"Açık kaynak modeller arasında en güçlü yönerge takibi"	Model kartı
Çalışma aralığı	Yaklaşık 4 MP ile 20 MP arası, en iyi sonuçlar 16 MP civarında	Model kartı

Hız iddiası, normalde adım başına işi iki katına çıkaran classifier-free guidance olmadan ve 6 damıtılmış adıma dayanıyor. MiniMax, 10 saniyelik değerin arkasındaki donanımı belirtmiyor; dolayısıyla bunu kendi GPU'nuz için bir vaat olarak okumayın.

Model kartı, yönerge takibi iddiasının arkasında hiçbir kıyaslama tablosu yayımlamıyor. Kardeş yazımız olan MiniMax H3-Image vs Nano Banana 2.1 yazısı, ikisini yan yana karşılaştırıyor.

Modelin içinde ne var?

Model kartı mimari konusunda alışılmadık derecede detaylı:

Difüzyon transformatörü: 50 katmanlı, tek akışlı yoğun (dense) bir transformatör olan 33.1B parametre, BF16 olarak saklanıyor (68,65 GB).
Metin kodlayıcı: değişmeden kalan MiniMax-H3 metin kodlayıcı, ayrı MiniMax-H3 deposundan yükleniyor (66,7 GB).
Görsel VAE: 16x uzamsal alt örnekleme ve 24 latent kanalı (2,34 GB).
İsteğe bağlı istem genişletici: MiniMax-H3-Image-PE (17,9 GB, NVFP4); kısa bir istemi modelin beklediği detaylı İngilizce açıklamaya dönüştürüyor.

Bunları topladığınızda, isteğe bağlı genişletici hariç eksiksiz bir yerel kurulum yaklaşık 137 GB indiriyor.

MiniMax H3-Image için "açık ağırlıklı" ne anlama geliyor?

MiniMax H3-Image açık ağırlıklıdır, ancak OSI anlamında açık kaynak değildir. Ağırlıkları indirebilir ve çalıştırabilirsiniz, fakat MiniMax-H3-Image Topluluk Lisansı gerçek sınırlamalar getirir. Üzerine bir şey inşa etmeden önce okuyun. Çoğu ekibi etkileyen noktalar:

Bölge. Lisans, "Hariç Tutulan Bölgeler" dışında dünya genelinde haklar tanır: Avrupa Birliği, Birleşik Krallık, Kore Cumhuriyeti ve Amerika Birleşik Devletleri. Bu bölgelerdeki ekiplerin MiniMax ile iletişime geçip ayrı bir lisans alması gerekir.
Gelir ve barındırma. Sizin ve bağlı kuruluşlarınızın yıllıklandırılmış geliri 1 milyon doları aşarsa ya da modeli üçüncü taraflara barındırılan bir hizmet olarak sunarsanız, MiniMax'ten önceki yazılı izni almanız gerekir. Talepler MiniMax'in lisans konsolu üzerinden yapılır.
Atıf. Ticari ürünler, kullanıcı arayüzünde "MiniMax-H3-Image" adını belirgin şekilde göstermelidir.
Başka modeller eğitme yasağı. Modeli veya çıktılarını başka herhangi bir yapay zeka modelini geliştirmek için kullanamazsınız.
Açıklama zorunluluğu. Kabul edilebilir kullanım politikası, üretilmiş içeriğin makine tarafından üretildiği açıkça belirtilmeden herkese açık şekilde yayımlanmasını yasaklar.

MiniMax, ürettiğiniz görseller üzerinde herhangi bir hak iddia etmiyor. Yalnızca barındırılan API'yi çağırıyorsanız, bu kullanım için MiniMax'in platform şartlarını da okuyun.

MiniMax H3-Image'i nerede kullanabilirsiniz?

Diagram of the four ways to reach MiniMax H3-Image: the MiniMax API endpoints, the Hailuo AI web app, the MiniMax Code desktop app, and the open weights on Hugging Face for self-hosting

Dört yolunuz var:

MiniMax API. POST https://api.minimax.io/v1/images/generations adresinde metinden görüntüye, /v1/images/edits adresinde düzenleme; her ikisi de MiniMax-H3-Image veya daha hızlı MiniMax-H3-Image-Highspeed model kimliğiyle çalışır. Eksiksiz anlatım MiniMax H3-Image API rehberimizde.
Hailuo AI. MiniMax'in web uygulaması, kod gerekmez.
MiniMax Code. macOS ve Windows için MiniMax'in masaüstü uygulaması; lansman gönderisinde H3-Image'in kullanılabileceği bir yer olarak anılıyor.
Kendi sunucunuzda barındırma. MiniMax, SGLang, vLLM-Omni, diffusers veya ComfyUI öneriyor ve desteklenen hızlandırıcılar arasında NVIDIA H200, RTX PRO 6000 Blackwell ve AMD Instinct MI350X'i listeliyor. Model kartı minimum VRAM değeri belirtmiyor.

Maliyetsiz yollar arıyorsanız, MiniMax H3-Image ücretsiz yazısı bunları ele alıyor.

MiniMax H3-Image API'si nasıl çalışır?

API, OpenAI tarzı bir görsel yapısını izler, dolayısıyla istek kısadır:

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": "An orange cat on a sunny windowsill, film texture",
    "aspect_ratio": "16:9",
    "area": "4K",
    "response_format": "url"
  }'

API referansından bilinmesi gereken parametreler:

size parametresi WIDTHxHEIGHT (655.360 ila 20.000.000 piksel, en-boy oranı 1:3 ile 3:1 arası) veya auto alır. auto ile aspect_ratio ve area (1K, 2K veya 4K, varsayılan 4K) değerlerini ayarlarsınız. İki biçimi karıştırmak 400 hatası döndürür.
n, istek başına 1 ila 10 görsel ister.
output_format varsayılan olarak jpeg'tir; png veya webp de olabilir.
response_format url (URL'nin kalıcı olacağı garanti edilmediğinden kendiniz indirin) veya b64_json'dir.
stream: true, her görseli bittiği anda server-sent events üzerinden iletir.
İstem geliştirme varsayılan olarak açıktır. Her sonuç, modelin gerçekte ne kullandığını gösteren bir revised_prompt taşır. İsteminizi olduğu gibi göndermek için disable_prompt_enhanced: true ayarlayın.

Bir davranış insanları yanıltır: en az bir görsel başarılı olursa, diğerleri içerik güvenliği kontrolünden geçememiş olsa bile çağrı HTTP 200 döndürür. Her öğede data[].error alanını kontrol edin. Yalnızca başarılı görseller için faturalandırma yapılır.

Rehber ayrıca desteklenmeyenleri listeler: önizleme görselleri, maskeli düzenlemeler ve şeffaf arka planlar.

Düzenleme için, her istekte toplam 64 MiB sınırıyla, 1 ila 16 referans görseli herkese açık URL'ler, yüklenmiş dosya kimlikleri veya data URI'leri olarak gönderirsiniz. İsteminiz bunlara yükleme sırasına göre <Picture 1>, <Picture 2> vb. şeklinde atıfta bulunur.

MiniMax H3-Image fiyatlandırması ve lansman haftası indirimi

MiniMax, H3-Image'ı milyon token başına; metin girdisi, görsel girdisi ve görsel çıktısı olarak bölünmüş şekilde faturalandırır. 11 Kasım 2026'da kontrol edilen MiniMax fiyatlandırma sayfasından:

Model	Girdi metni / M token	Girdi görseli / M token	Çıktı görseli / M token
MiniMax-H3-Image	$2,30	$1,50	$3,80
MiniMax-H3-Image-Highspeed	$2,30	$3,00	$7,60

Standart modelde metinden görüntüye sonuç başına MiniMax'in kendi örnek maliyetleri 1K'da $0,02179, 2K'da $0,02333 ve 4K'da $0,06879'dur. Highspeed 4K örneği $0,13001'dir.

Lansman indirimi, teslim edilen görsel en az 16.600.000 piksel içerdiğinde her iki modelde de toplam istek maliyetinde %50'dir. İndirim 17 Kasım 2026, 16:00 UTC'ye kadar geçerlidir. Bu süre boyunca MiniMax, standart bir 4K metinden görüntüye sonucunu $0,03439 ve Highspeed olanı $0,06501 olarak listeliyor. Daha küçük görseller hakk kazanmaz; dolayısıyla 2K bir çıktı eskisi kadar maliyetlidir.

MiniMax H3-Image API'sini Apidog CLI ile test edin

H3-Image'ı bir uygulamaya bağlamadan önce; istek yapınızın, kimlik doğrulamanın ve hata işlemenizin çalıştığını — "başarısız öğeyle birlikte 200" durumunu da kapsayacak şekilde — kanıtlayın. İstekleri elle tıklamak yerine kodlama ajanınızın bu kontrolü Apidog CLI ile oluşturup çalıştırmasına izin verin.

Workflow diagram: a coding agent uses Apidog CLI to create an endpoint and test case, calls POST /v1/images/generations on MiniMax H3-Image, reads a test report checking status 200, data[0].url and no data[].error, then fixes and reruns

CLI'yı bir kez kurun:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Skill, ajanınıza (Claude Code, Codex, Cursor veya başka biri) CLI komutlarını öğretir. Ardından ona tek bir istem verin:

In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.

Ajan bunu kısa bir apidog komut dizisine dönüştürür. Aşağıdaki her bayrak, Apidog CLI 2.2.12 üzerindeki apidog <command> --help çıktısından alınmıştır:

apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json

cli-schema get, ajana tam JSON yapısını verir ve cli-schema validate, hiçbir şey yazılmadan önce her dosyayı kontrol eder. test-case category, geçerli bir kategori kimliği verir; böylece test durumu uygulamada görünür. Çalıştırma, terminalinizde geçti/kaldı özetini yazdırır ve ajanın neyi düzelteceğine karar vermesi için okuduğu bir JSON raporu oluşturur. Aynı çalıştırmayı Apidog içinde görmek için --upload-report ekleyin.

area: 1K kullanmak, her test çağrısını MiniMax'in listelenen en düşük örnek fiyatında tutar. Kalıp hakkında daha fazla bilgi için Apidog CLI ajan iş akışına ve Claude Code'da Apidog CLI yazısına bakın. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar.

MiniMax H3-Image'ı denemeli misiniz?

Büyük, detaylı görsellere ihtiyacınız varsa ve açık ağırlıklı bir seçenek istiyorsanız ya da çoklu referans düzenlemesi (ürün fotoğrafları, oda yerleşimleri, karakter sayfaları) kullanım senaryonuzsa deneyin. Lansman indirimi, 17 Kasım'a kadar 4K testlerini ucuz tutuyor.

Kendi sunucunuzda barındırmadan önce iki kez düşünün: yaklaşık 137 GB ağırlık, veri merkezi GPU'ları ve AB'yi, Birleşik Krallık'ı, Kore Cumhuriyeti'ni ve ABD'yi dışlayan bir lisans. Çoğu ekip için API pratik yoldur. Görsel API'lerini karşılaştırıyorsanız, GPT Image 2.6 API, Nano Banana 2.1 API ve Qwen-Image 2.1 rehberlerimiz alternatifleri ele alıyor.

SSS

MiniMax H3-Image ücretsiz mi? Ağırlıklar, lisansın bölgesi içinde, gelir ve barındırma sınırlamaları çerçevesinde indirilip çalıştırılmak üzere telifsizdir. API ise token başına ücretlidir. Maliyetsiz yollar için ücretsiz erişim rehberimize bakın.

MiniMax H3-Image açık kaynak mı? MiniMax, Hugging Face'te ona açık kaynak diyor; ancak model, bölge, gelir, atıf ve eğitim yasağı kısıtlamaları içeren özel bir topluluk lisansıyla yayımlanıyor. Daha doğru terim "açık ağırlıklı"dır.

MiniMax H3-Image ne kadar hızlı? MiniMax, 4K bir görselin yaklaşık 10 saniye sürdüğünü söylüyor. Bu şirketin verisidir; donanımı belirtmiyor ve bu yazı yazıldığında bağımsız bir kıyaslama mevcut değildi.

MiniMax-H3-Image ile MiniMax-H3-Image-Highspeed arasındaki fark nedir? İkisi de aynı parametreleri ve sınırları alır. Highspeed daha hızlı katmandır ve daha pahalıdır: milyonluk çıktı görsel tokenı başına $7,60'a karşılık $3,80.

MiniMax H3-Image kaç referans görsel kullanabilir? Düzenleme isteği başına 16'ya kadar; her biri kenar başına 128 ila 8.192 piksel, tüm istek gövdesi 64 MiB ile sınırlıdır.

MiniMax H3-Image lansman indirimi ne zaman bitiyor? 17 Kasım 2026, 16:00 UTC. İndirim yalnızca en az 16.600.000 piksellik görsellere uygulanır.