MiniMax H3 Image API: generazione, editing e prezzi reali

Prezzi dello stesso modello tra fornitori: Cheap MiniMax H3 Image API · 2026-11-13

Capacità di MiniMax H3 Image e limiti dell'API ospitata

Il motivo più forte per valutare H3 Image è il suo flusso unificato di generazione ed editing: descrivi un nuovo asset, fornisci riferimenti di prodotto o personaggio, poi richiedi una modifica mirata. MiniMax pubblica anche i pesi per il deployment locale. Le dichiarazioni di capacità pubblicate non garantiscono la conservazione esatta di loghi, tipografia o identità in ogni output.

Funzionalità API ospitata	Contratto documentato
Generazione	POST /v1/images/generations
Editing	POST /v1/images/edits, da 1 a 16 immagini di riferimento
Prompt	Fino a 32.000 caratteri; senza enhancement hanno effetto solo circa i primi 4.096 token
Dimensioni output	Da 655.360 a 20.000.000 pixel; rapporto d'aspetto da 1:3 a 3:1
Numero di output	n da 1 a 10
Formati	JPEG per impostazione predefinita; PNG o WebP supportati
Risposte	URL o Base64 non in streaming; SSE nativo supportato
Controlli non supportati	Editing con maschera, sfondi trasparenti e immagini di anteprima

I file di riferimento devono rispettare i limiti di input di MiniMax: JPG/JPEG, PNG, WebP, HEIC o HEIF, ogni dimensione tra 128 e 8.192 pixel, rapporto tra lato lungo e corto massimo 4:1 e corpo totale della richiesta al massimo 64 MiB. Base64 aumenta la dimensione della richiesta. Usa URL di immagini accessibili o upload di dimensioni adeguate; la capacità del modello di accettare 16 immagini non elimina il limite sulla dimensione del corpo.

"4K" in questa API è un'impostazione di area. area: "4K" punta a circa 4096 × 4096 pixel, con dimensioni derivate dal rapporto d'aspetto. In 16:9, l'output documentato è 5472 × 3072, non 4096 × 2304. Per dimensioni esplicite, invia size: "WIDTHxHEIGHT" e ometti area e aspect_ratio. Per il dimensionamento basato su area, usa size: "auto", area e aspect_ratio. Controlla data[].size e le dimensioni effettive dell'immagine scaricata.

Quanto costa MiniMax H3 Image?

Per la rotta Standard attuale su APIMaster, il calcolo a prezzo regolare è:

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

Usa campi distinti per l'utilizzo di testo e immagini; non addebitare tutti i token di input come testo per poi sommare di nuovo l'input immagine. L'enhancement del prompt contribuisce ai token di testo fatturati, quindi la sola risoluzione non determina il totale. I coefficienti specifici dell'account, ove applicabili, e gli arrotondamenti di fatturazione possono influire sull'addebito finale.

I totali Standard illustrativi ufficiali di MiniMax mostrano l'ordine di grandezza della fattura. Questi sono esempi, non tariffe fisse di APIMaster né una nostra media misurata:

Attività	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, tariffa regolare
Text-to-image	$0.02179	$0.02333	$0.06879
Editing con un riferimento 1K	$0.02654	$0.02658	$0.07312
Editing con tre riferimenti 1K	$0.03563	$0.04177	$0.07914

Per contesto, 1.000 richieste text-to-image al primo esempio corrisponderebbero a circa $21,79; è un calcolo illustrativo basato sul budget di token, non un pacchetto prepagato. I prompt effettivi e l'enhancement possono modificarlo. Nano Banana 2.1 ha un contratto APIMaster diverso, basato sulla risoluzione, a partire da $15,12 per 1.000 immagini 1K prima di eventuali condizioni quotate separatamente.

La promozione ufficiale del 50% sul 4K si applica su APIMaster?

Non darlo per scontato. MiniMax pubblicizza il 50% di sconto sul costo totale della richiesta per Standard e Highspeed fino al 17 novembre 2026, ore 16:00 UTC, escluso—18 novembre alle 00:00 ora di Pechino—quando l'immagine finale consegnata ha almeno 16.600.000 pixel. Il suo esempio quadrato 4K text-to-image passa da $0.06879 a $0.03439 durante l'offerta.

Un output 4096 × 4096 è idoneo per area; 4096 × 2304 no. La sola etichetta "4K" non è sufficiente. L'attuale rotta pubblica APIMaster usa le tariffe regolari a token, senza questa promozione temporanea. Confronta il contratto effettivo di checkout/utilizzo, non il titolo della campagna MiniMax. Dopo la scadenza, gli esempi promozionali non devono essere usati come prezzi correnti.

Esempio API di MiniMax H3 Image: text-to-image

Crea un account APIMaster, aggiungi saldo per le richieste di immagini a pagamento, poi crea una chiave in API keys. Imposta APIMASTER_API_KEY nel tuo ambiente. Questo esempio usa l'ID modello esatto e case-sensitive della rotta Standard:

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"))

Questo è un esempio di richiesta, non un benchmark di qualità delle immagini. Scarica tempestivamente gli URL degli output riusciti e archivia i file autonomamente. Controlla gli errori per singola immagine: con n > 1, un HTTP 200 può includere immagini fallite. Un timeout non dimostra che una richiesta sia stata rifiutata. La generazione H3 non è idempotente, quindi un nuovo tentativo automatico può creare un'altra generazione a pagamento. Se usi l'SDK OpenAI, imposta un timeout sufficientemente lungo e max_retries=0.

Editing con MiniMax H3 Image: immagini di riferimento e controllo del prompt

Per l'editing JSON, invia gli URL di riferimento in images[].image_url. Non copiare il campo image_urls di Nano Banana in questa richiesta H3. Sostituisci gli URL di esempio con i tuoi asset accessibili:

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())

I test di accettazione dell'integrazione APIMaster dell'11 novembre hanno coperto riferimenti HTTP, data URI, upload multipart, editing multi-riferimento, SSE e output decodificati a 1K/2K/4K. Un test controllato con due riferimenti ha mantenuto quattro forme colorate e due etichette brevi. Si è trattato di verifiche di interfaccia e fatturazione con asset semplici, non di una valutazione fotografica o tipografica approfondita; non stabiliscono una superiorità rispetto a un altro modello.

La generazione usa l'enhancement del prompt per impostazione predefinita; puoi disattivarlo con disable_prompt_enhanced: true fornendo dimensioni fisse o un rapporto d'aspetto fisso. L'editing usa sempre l'enhancement. Esamina revised_prompt quando diagnostichi modifiche inattese. Per il lavoro su prodotto, specifica ciò che deve restare fisso, identifica il ruolo di ciascun riferimento e verifica l'etichetta renderizzata prima della pubblicazione.

Standard vs Highspeed, e pesi aperti vs API ospitata

Highspeed usa gli stessi parametri API documentati, ma le sue tariffe ufficiali di input immagine e output immagine sono il doppio di quelle di Standard; l'input testo resta $2.30/M. APIMaster attualmente elenca solo Standard. Le dichiarazioni ufficiali di velocità al lancio di MiniMax dipendono da variante del modello, dimensione e deployment e non costituiscono una garanzia misurata di latenza APIMaster.

Il repository ufficiale su Hugging Face fornisce pesi e integrazioni tra cui Diffusers, SGLang, vLLM-Omni e ComfyUI. Il suo checkpoint BF16 è di circa 68,65 GB, con un text encoder separato di circa 66,7 GB. La dimensione del download non è una stima completa della memoria GPU. I pesi locali sono soggetti alla licenza community di MiniMax H3 Image, quindi esamina la licenza prima del deployment; "pesi aperti" non significa uso illimitato secondo MIT o Apache.

Usa l'accesso ospitato per valutare i prompt senza costruire un'infrastruttura di inferenza. Considera il deployment locale quando il controllo sull'inferenza giustifica lavoro su GPU, manutenzione e licenze. I limiti delle pipeline locali e quelli dell'API ospitata sono contratti diversi.

FAQ

MiniMax H3 Image è lo stesso di MiniMax H3 video?

No. H3 Image genera e modifica immagini statiche usando MiniMax-H3-Image. La famiglia video H3 ha ID modello, endpoint e fatturazione diversi. Consulta la guida separata su MiniMax H3 video.

MiniMax H3 Image è disponibile su APIMaster?

Sì. La verifica del 13 novembre ha rilevato una rotta pubblica Standard abilitata, fatturata a $2.30/M input testo, $1.50/M input immagine e $3.80/M output immagine. Highspeed non aveva rotte pubbliche. Controlla la scheda modello live prima di inviare richieste.

H3 Image è un'API a prezzo fisso di $0,02 per immagine?

No. Gli esempi ufficiali per immagine sono totali illustrativi. L'utilizzo effettivo dei token, l'enhancement del prompt, gli input di riferimento e le dimensioni dell'output determinano la fattura. L'attuale rotta APIMaster usa la formula regolare a token.

H3 Image può fare editing con 16 riferimenti o una maschera?

Documenta fino a 16 immagini di riferimento entro i limiti di formato e dimensione della richiesta. L'editing con maschera e gli sfondi trasparenti non sono supportati. Le istruzioni basate sui riferimenti non garantiscono una conservazione pixel-perfect.

Qual è più economico: H3 Image o Nano Banana 2.1?

Per l'attività illustrativa text-to-image 1K, l'esempio ufficiale regolare di H3 è $0.02179, contro Nano Banana 2.1 su APIMaster a partire da $0.01512 per immagine 1K. Questo confronta un totale esempio a token con una quotazione per risoluzione; misura il costo effettivo per output accettato sui tuoi prompt. Vedi il confronto dedicato.

Fonti e prossimi passi

Fonti verificate il 13 novembre 2026: rilascio MiniMax, guida API ospitata, prezzi e promozioni ufficiali, pesi del modello e licenza, prezzi immagini Google e le schede live del marketplace APIMaster. Le descrizioni delle capacità provengono dai rispettivi fornitori; le verifiche dei prezzi e le osservazioni datate sull'integrazione APIMaster sono identificate separatamente.

Apri la scheda H3 Image, registrati, crea una API key e invia MiniMax-H3-Image a https://apimaster.ai/v1. Per un'alternativa scontata con un contratto di fatturazione diverso, confronta le rotte Nano Banana 2.1, attualmente fino al 55% sotto il riferimento di output immagine di Google.