Per generare immagini da testo in 4K, MiniMax H3-Image propone numeri interessanti: secondo il grafico di latenza di MiniMax, Highspeed raggiunge una P50 di 10,3 secondi, mentre Standard arriva a 16,0 secondi. L'esempio di costo Standard per il 4K è di $0.06879, meno della tariffa hosted di terze parti indicata in questo articolo (WaveSpeed: $0.03 per immagine a 1K/2K, $0.09 a 4K); Highspeed, a $0.13001, costa invece di più. Se però l'editing multi-reference deve mantenere fedelmente identità e soggetti, le testimonianze degli utenti collegati suggeriscono di valutare altro.
4K in circa 10 secondi, ma l'editing iniziale lascia dubbi
H3-Image è un nuovo modello image open-weight costruito sulla base del video model MiniMax H3. Supporta text-to-image, generazione guidata da reference ed editing, con fino a 16 immagini di riferimento e 10 output per richiesta. I livelli di area 1K/2K/4K corrispondono rispettivamente a 1.048.576 / 4.194.304 / 16.777.216 pixel; il server ricava larghezza e altezza esatte dal rapporto d'aspetto e le restituisce in data[].size. In altre parole, 4K è un'area target e non implica necessariamente un quadrato letterale di 4096×4096 pixel.
MiniMax dichiara una P50 convincente, anche se il confronto sul 4K è limitato. Nel grafico P50 di MiniMax, il text-to-image Highspeed passa da 7,7 s a 1K a 10,3 s a 4K; Standard va da 10,6 s a 16,0 s. Sul 4K il grafico mette a confronto soltanto Nano Banana 2.1, indicato a 50–51 s: l'affermazione di essere “5x più veloce dei modelli mainstream” poggia quindi su un campione ristretto.
Nelle discussioni Reddit collegate, i commentatori confermano un T2I rapido ma segnalano gli stessi due limiti: perdita di somiglianza nelle reference e dettagli morbidi anche alle risoluzioni dichiarate più elevate.
"Purtroppo, come modello ref2i è molto scarso rispetto al vero modello video H3 per il ref2i" — u/Omegapepper su r/StableDiffusion
"Forse qualcuno se la prenderà, ma da quanto ho testato è sensibilmente inferiore a QI 2.1 [...] nell'editing multi-reference." — u/Crazy-Repeat-2006 su r/StableDiffusion
Nella discussione sulle dimensioni consigliate collegata, chi ha provato il modello descrive output a bassa risoluzione morbidi e sfocati dove dovrebbe esserci nitidezza, e si interroga sulla presenza di vero dettaglio ad alta frequenza dietro le risoluzioni dichiarate. Sono segnalazioni aneddotiche e iniziali, non un benchmark controllato, ma indicano tutte la stessa tendenza.
API MiniMax: due modelli, due endpoint e l'espansione del prompt
La documentazione API di MiniMax espone due model ID, due endpoint per le immagini e un passaggio per l'espansione del prompt.
| Voce | MiniMax-H3-Image (Standard) | MiniMax-H3-Image-Highspeed |
|---|---|---|
| Obiettivo | Costo minimo per immagine | Latenza minima |
| Input testuale | $2.30 / 1M token | $2.30 / 1M token |
| Input immagine | $1.50 / 1M token | $3.00 / 1M token |
| Output immagine | $3.80 / 1M token | $7.60 / 1M token |
Endpoint (di seguito l'host Global; gli account China devono usare l'endpoint China indicato nella stessa documentazione):
POST https://api.minimax.io/v1/images/generations— text-to-image; i parametri verificati includonomodel,prompt(massimo 32.000 caratteri),disable_prompt_enhanced(predefinito false),n(1–10),size(autooWIDTHxHEIGHT),aspect_ratio,area(1K/2K/4K, predefinito4K),output_format(predefinito jpeg),response_format(url/b64_json),stream,output_compression.POST /v1/images/edits— editing con 1–16 reference; le reference accettano JPG/PNG/WebP/HEIC/HEIF, con lato compreso tra 128 e 8192 px.H3-Image-Context-IR— passaggio di espansione del prompt, non un endpoint per immagini: riscrive un prompt breve e sceglie un rapporto d'aspetto.
Struttura pronta da copiare e incollare (host Global):
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"}'La documentazione specifica che le richieste non sono idempotenti, che il server può impiegare fino a 600 secondi e che la generazione prosegue anche se il client va in timeout o si disconnette. Un'immagine completata viene comunque addebitata, mentre sono fatturate solo le immagini riuscite (usage conta i successi). MiniMax raccomanda max_retries=0 con l'SDK OpenAI. Un successo parziale restituisce HTTP 200 con voci data[].error per le singole immagini, inclusi gli errori di content safety: occorre quindi controllare ogni elemento. Solo i batch interamente falliti restituiscono 4xx/5xx. Considera la maggior parte dei 4xx come errori di configurazione definitivi, non inviare mai di nuovo una POST dopo timeout ambigui e, con provider asincroni, interroga il job esistente anziché crearne un altro.
L'enhancement del prompt è attivo per impostazione predefinita. Si può disattivare nel text-to-image, ma non negli edit; l'API restituisce il prompt riscritto in data[].revised_prompt. Registralo e confrontalo con il prompt inviato prima di modificare qualsiasi altra impostazione. Attenzione ai limiti con enhancer disattivato: il modello legge allora approssimativamente i primi 4.096 token e devi fornire una dimensione esatta oppure un rapporto d'aspetto esplicito.
Self-hosting: non bastano 10 secondi, servono pesi, VRAM e licenza
I pesi sono disponibili su Hugging Face MiniMaxAI/MiniMax-H3-Image e GitHub MiniMax-AI/MiniMax-H3-Image, insieme ai pesi convertiti per ComfyUI e al template workflow image_minimax_h3_image_t2i.json. La model card documenta un diffusion transformer da 33,1B parametri, un checkpoint BF16 da 68,65 GB e un text encoder H3 separato da 66,7 GB: circa 135 GB prima dell'eventuale prompt expander da 17,9 GB. La card fissa il server locale a 6 inference step con guidance scale 1; altri valori restituiscono HTTP 400 in quel contesto. Non sono previsti negative prompt.
Non aspettarti 10 secondi da una scheda gaming. Nelle discussioni ComfyUI ci si chiede se il modello possa entrare persino in una 5090 con quantizzazione a 4 bit. Nella discussione open-weight collegata, un utente RTX 5090 riporta circa 21 secondi per 16 MP in INT8, con output granuloso e necessità di BF16 per ottenere nitidezza, a fronte di tempi maggiori. Un utente RTX 3070 Ti, nella discussione ComfyUI, definisce rapido il T2I per output da 16 MP, ma afferma che l'editing con reference ignorava il prompt: un singolo dato utente, non una prova che una quantizzazione aggressiva sia sicura per il lavoro con reference.
Per molti team la licenza conta più della VRAM. La model card usa la MiniMax-H3-Image Community License Agreement datata 10 novembre 2026: la concessione predefinita esclude Stati Uniti, Unione Europea, Regno Unito e Repubblica di Corea; richiede autorizzazione scritta preventiva oltre $1M di fatturato annualizzato o per servizi hosted destinati a terze parti; inoltre impone alle interfacce commerciali di mostrare "MiniMax-H3-Image". I team con sede negli Stati Uniti o nell'UE dovrebbero chiarire la licenza prima di procedere con il self-hosting.
Quanto costa un'immagine a 1K, 2K e 4K: gli esempi MiniMax
Tutte le cifre seguenti sono esempi di costo forniti da MiniMax, non prezzi fissi: la fatturazione è basata sui token, perciò lunghezza del prompt e numero di reference modificano il totale. Gli esempi con reference assumono immagini di riferimento a 1K.
| Attività | Esempio Standard | Esempio Highspeed |
|---|---|---|
| T2I area 1K | $0.02179 | $0.03529 |
| T2I area 2K | $0.02333 | $0.03622 |
| T2I area 4K | $0.06879 ($0.03439 promo) | $0.13001 ($0.06501 promo) |
| Edit 4K + 1 reference | $0.07312 ($0.03656 promo) | $0.13673 ($0.06837 promo) |
| Edit 4K + 3 reference | $0.07914 ($0.03957 promo) | $0.15407 ($0.07703 promo) |
Tre aspetti aiutano a contenere i costi. Primo: 2K costa quasi quanto 1K ($0.02333 contro $0.02179) pur avendo 4x i pixel target; quando entrambe le opzioni sono adatte, conviene ordinare 2K invece di 1K. Secondo: il 4K contiene 16x i pixel del 1K a circa 3,2x il prezzo dell'esempio, quindi il 4K nativo è efficiente quando serve dettaglio da stampa. Terzo: la promo di lancio dimezza il 4K idoneo a $0.03439 Standard fino al 17 novembre 2026 alle 16:00 UTC, per output con almeno 16.600.000 pixel.
Highspeed raddoppia approssimativamente le tariffe dei token immagine per risparmiare 3–7 secondi. Nel T2I 4K significa $0.13001 contro $0.06879, ovvero 1,89x. A meno di generare cataloghi in batch con un SLO di latenza, Standard è la scelta migliore. Ogni reference aggiuntiva introduce token di input immagine: un edit 4K con 3 reference costa circa l'8% in più di uno con 1 reference, prima ancora di considerare la qualità.
Meglio questa API, Qwen, Krea o H3 video?
Se il carico di lavoro consiste in text-to-image ad alta risoluzione in grandi volumi, H3-Image è interessante sulla base degli esempi di prezzo e latenza pubblicati da MiniMax. Se invece conta la conservazione dell'identità, conviene confrontare le alternative qui sotto prima di scegliere.
| Caso d'uso | Scelta | Motivo |
|---|---|---|
| Poster, sfondi e paesaggi 4K T2I in grandi volumi | H3-Image Standard | Esempi da $0.023 per 2K e $0.069 per 4K; 4K più rapido nel grafico MiniMax |
| Batch sensibili alla latenza, come annunci e anteprime live | H3-Image Highspeed | Da 7,7 s a 1K a 10,3 s a 4K; 1,9x di costo per risparmiare ~6 s |
| Coerenza di personaggi o prodotti con più reference | Qwen Image via Alibaba Cloud o H3 video ref2i | Le discussioni collegate descrivono H3-Image come più debole di QI 2.1 negli edit multi-reference; diversi utenti continuano a usare H3 video per il ref2i |
| Interfaccia di editing gestita invece di API/self-hosting | Krea | Nessun footprint locale di ~135 GB; alternativa UI, non equivalente a un'API |
| Self-hosting con 24GB o meno | Attendere build pruned/INT4 | Oggi BF16 richiede VRAM di classe datacenter |
Quando la somiglianza è essenziale, il vantaggio di prezzo per immagine svanisce rapidamente nei tentativi ripetuti.
Checklist di rilascio per evitare costi inutili e immagini sfocate
- Parti dai preset 1K/2K e passa al 4K solo per le immagini da conservare; i tester segnalano un 4K predefinito morbido, quindi verifica prima la nitidezza a 2K.
- Registra
revised_prompta ogni esecuzione e confrontalo con il prompt inviato prima di cambiare altro. - Imposta timeout client superiori a 600 s, perché il server può richiedere fino a 600 s; disattiva i retry automatici dell'SDK, tieni una chiave di deduplicazione lato client solo per la riconciliazione e, con provider asincroni, interroga il job invece di inviare di nuovo la POST.
- Gestisci le voci
data[].errorper singola immagine nei batch multi-output con HTTP 200; prima di implementare il loop, verifica l'envelope degli errori nella referenza degli edit. - Verifica licenza,
response_formate download dei prompt: secondo la documentazione API, le risposteurlnon sono garantite come archiviazione durevole.
FAQ su MiniMax H3-Image API
Che differenza c'è tra MiniMax H3-Image e MiniMax H3?
H3 è il modello video; H3-Image è il modello per immagini statiche costruito su H3, pensato per text-to-image ed editing su aree di classe 4K. Per la coerenza reference-to-image, diversi utenti nelle discussioni collegate preferiscono ancora H3 video.
Quali sono endpoint ufficiale e model ID?
POST https://api.minimax.io/v1/images/generations con model: MiniMax-H3-Image oppure MiniMax-H3-Image-Highspeed, più /v1/images/edits e H3-Image-Context-IR per l'espansione del prompt.
Posso disattivare l'enhancement del prompt?
Nel text-to-image sì, usando disable_prompt_enhanced: true; nell'editing no. L'API restituisce il prompt riscritto effettivamente utilizzato.
Posso eseguire H3-Image in locale su una GPU consumer?
Solo con quantizzazione e pazienza: in BF16 servono ~135 GB prima del prompt expander. La model card indica acceleratori di classe H200, RTX PRO 6000 e MI350X per le configurazioni server.
È utilizzabile commercialmente?
Solo dopo aver chiarito la MiniMax-H3-Image Community License: la concessione predefinita esclude Stati Uniti, UE, Regno Unito e Corea e richiede autorizzazione oltre $1M di fatturato o per servizi hosted rivolti a terze parti.