MiniMax

MiniMax H3 Image

minimax-h3-image/image-to-image

Modello di immagini MiniMax: generazione da testo e modifica con 1–16 immagini di riferimento condividono lo stesso set di capacità, output fino a 4K, supporto per dieci formati e proporzioni automatiche, ideale per concept design, visual commerciali e creazione multi-stile

minimax-h3-image/image-to-image minimax-h3-image/text-to-image

Prova minimax-h3-image/image-to-image

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

minimax-h3-image/image-to-image per image

Specifiche	Prezzo unitario
1K	$0.0129 + $0.0036 Per Reference Image
2K	$0.0129 + $0.0036 Per Reference Image
4K	$0.0393 + $0.0036 Per Reference Image

Panoramica e posizionamento

Servizio di generazione image-to-image basato su immagini di riferimento, pensato per sviluppatori con esigenze di editing e compositing di immagini. Accetta da 1 a 16 immagini JPG, PNG o WEBP come riferimento, da citare nel prompt nell'ordine delle immagini come Picture 1, Picture 2 e così via, descrivendo l'editing o la fusione da eseguire. L'output è un'immagine statica, con tre livelli di risoluzione 1K, 2K e 4K e diversi rapporti d'aspetto, in formato JPEG o PNG, adatta a concept design, modifica di materiali visivi e compositing di più immagini.

Punti di forza principali

Supporto alla fusione con più riferimenti——è possibile inviare fino a 16 immagini di riferimento in una sola richiesta, modificando o combinando più immagini; ogni immagine di riferimento viene fatturata singolarmente.
Risoluzione di output selezionabile a livelli——offre tre livelli di risoluzione di output 1K, 2K e 4K, pari a circa 1MP, 4MP e 16MP, selezionabili in base all'uso del materiale.
Seed fisso per risultati riproducibili——tramite il parametro seed è possibile fissare il seed casuale per riprodurre i risultati; se omesso, viene usato un seed casuale.
Rapporto d'aspetto con selezione automatica——aspect_ratio è impostato per default su auto e il modello decide il rapporto di output in base al prompt e alle immagini di riferimento; è comunque possibile specificare 10 rapporti fissi.

Descrizione delle capacità

Editing e fusione con più riferimenti: inviando da 1 a 16 immagini di riferimento e un prompt di editing fino a 5000 caratteri, citando Picture 1, Picture 2 e così via nell'ordine delle immagini, è possibile modificare immagini esistenti o combinare più immagini in una nuova scena, ottenendo un'immagine statica.

Controllo della risoluzione di output e del formato: resolution può essere 1K, 2K o 4K, corrispondenti a un output di circa 1MP, 4MP e 16MP; aspect_ratio supporta 11 rapporti d'aspetto tra cui 1:1, 16:9 e 21:9, con default auto, deciso automaticamente dal modello in base al prompt e alle immagini di riferimento.

Formato di output e controllo del seed: output_format può essere jpeg o png; PNG pesa circa 12MB a 2K e circa 30MB a 4K; seed accetta numeri interi da 0 a 2147483647 per riprodurre i risultati; se omesso, è casuale.

Scenari di utilizzo

Modifica di concept design basata su immagini di riferimento——il designer carica immagini di riferimento di personaggi o scene e descrive la direzione delle modifiche, ottenendo concept art modificata da usare per l'elaborazione delle proposte e la comunicazione visiva.
Compositing di materiali visivi commerciali da più immagini——usando più immagini di prodotto o di sfondo come input di riferimento, si generano materiali ad alta risoluzione dopo la fusione, destinati ad advertising ed esposizione e-commerce.
Editing di immagini esistenti tramite istruzioni——operatori o creatori di contenuti caricano immagini esistenti e descrivono le modifiche desiderate, ottenendo immagini statiche modificate per i social media o per illustrare pagine.

Limiti e consigli per la scelta

Ogni richiesta deve contenere almeno 1 e al massimo 16 immagini di riferimento; ciascuna immagine deve avere lati compresi tra 128 e 8192 pixel, dimensioni non superiori a 20MB e formato limitato a JPG, PNG o WEBP. Il prompt può contenere al massimo 5000 caratteri e deve includere contenuto non vuoto. Le immagini di riferimento sono fatturate a numero. L'output è un'immagine statica; non è supportata la generazione di contenuti video o audio. I file in formato PNG sono decisamente più pesanti dei JPEG, circa 30MB a 4K: occorre considerare i costi di archiviazione e trasferimento.

Novità

Vedi il changelog →

Nuovo modello MiniMax H3 Image è disponibile: generazione di immagini da testo e modifica con riferimenti multipli Nov 12, 2026

Domande frequenti

Vedi tutte le domande →

Quante immagini di riferimento si possono fornire al massimo?

L'immagine in ingresso accetta al massimo 16 immagini di riferimento alla volta, minimo 1, in formato JPG, PNG o WEBP, con un lato compreso tra 128 e 8192 px e un peso massimo di 20 MB per immagine. Ogni immagine di riferimento costa altri $0.0036, ad esempio 2K con 3 immagini di riferimento costa in totale $0.0129 + 3 × $0.0036 = $0.0237. Quando scrivi il prompt, fai riferimento a ciascuna immagine con numerazioni come Picture 1, Picture 2 seguendo l'ordine di invio, così il modello può associare correttamente gli oggetti che vuoi modificare o combinare.
Come si determinano le dimensioni di output e quanto possono essere grandi?

La risoluzione è disponibile in tre livelli: 1K, 2K e 4K, pari rispettivamente a circa 1 MP, 4 MP e 16 MP; il valore predefinito è 2K. Il rapporto può essere auto oppure 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9; scegliendo auto, è il modello a decidere in base al prompt e all'immagine di riferimento, mentre per una composizione fissa occorre specificarlo esplicitamente.
Come si deve scrivere il prompt per preservare l'aspetto del personaggio?

Organizza il testo in quest'ordine: «descrivi prima il soggetto da mantenere, poi scrivi la parte da modificare, infine indica le immagini con un numero»: ① inizia con una o due frasi che fissano i tratti esteriori del soggetto, come acconciatura, abbigliamento, combinazione di colori e dettagli distintivi; ② poi specifica la scena desiderata, la posa, l'inquadratura e l'illuminazione; ③ quando devi fare riferimento a un'immagine di riferimento, scrivi «la persona in Picture 1», numerando più immagini nell'ordine in cui vengono fornite. Il prompt ha un limite massimo di 5000 caratteri; inserire i dettagli nel corpo del testo è più efficace che accumulare aggettivi.
Come si crea una serie di immagini di ambientazione multiangolazione dello stesso personaggio?

Inizia usando un'immagine di riferimento chiara e senza occlusioni del soggetto come Picture 1, fissa la descrizione delle caratteristiche del personaggio nel prompt, poi genera un'immagine alla volta cambiando solo la descrizione dell'angolazione o della posa, ad esempio frontale, laterale, posteriore, mezzobusto e figura intera, con proporzioni fisse 3:4 o 1:1. Mantenere lo stesso seed per ogni immagine aiuta a ridurre le differenze casuali; la coerenza stilistica della serie si mantiene principalmente grazie all'immagine di riferimento e alla descrizione fissa del soggetto.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: minimax-h3-image/image-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per minimax-h3-image/image-to-image e la route default — vedi la tabella dei parametri sotto.

seedintegerOpzionalemin 0max 2147483647

Seme casuale, utilizzato per riprodurre lo stesso risultato; inserire un numero intero, se omesso viene usato un seme casuale.

promptstringObbligatoriominLength 1maxLength 5000pattern \S

Testo dell'istruzione di modifica, che deve fare riferimento alle immagini di riferimento in ordine come Picture 1, Picture 2, ecc.; lunghezza 1–5000 caratteri.

image_urlsarrayObbligatoriominItems 1maxItems 16

Array di immagini di riferimento da modificare o comporre, i cui elementi sono URL di immagini; supporta da 1 a 16 immagini JPG, PNG o WEBP, con lati da 128 a 8192 px e dimensione massima di 20 MB per immagine; ogni immagine di riferimento viene addebitata separatamente.

Array [ string ]

resolutionstringOpzionalePredefinito: "2K"

Livello di risoluzione dell'output: 1K circa 1 MP, 2K circa 4 MP, 4K circa 16 MP; predefinito 2K.

Opzioni:1K2K4K

aspect_ratiostringOpzionalePredefinito: "auto"

Rapporto larghezza-altezza dell'immagine di output; predefinito auto, scelto autonomamente dal modello in base al prompt e alle immagini di riferimento.

Opzioni:auto1:15:44:54:33:43:22:3

Mostra tutto (3)Mostra meno

16:99:1621:9

output_formatstringOpzionalePredefinito: "jpeg"

Formato dell'immagine di output; predefinito jpeg, i file PNG sono notevolmente più grandi (2K circa 12 MB, 4K circa 30 MB).

Opzioni:jpegpng

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-image/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "2K",
    "aspect_ratio": "auto",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-h3-image/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "2K",
      "aspect_ratio": "auto",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-h3-image/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "2K",
          "aspect_ratio": "auto",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}