API MiniMax H3 Image
Riferimento API completo per i modelli MiniMax H3 Image di generazione di immagini da testo e modifica delle immagini.
Varianti del modello
Questa API supporta due varianti del modello:
Confronto rapido
Proporzioni supportate
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Indicare le proporzioni come valori numerici separati di width e height, non come dimensioni in pixel. Se entrambi i valori vengono omessi, le proporzioni predefinite sono 1:1; altrimenti, indicare entrambi i valori utilizzando una delle coppie di numeri interi supportate.
MiniMax H3 Image (Da testo a immagine)
Punto di accesso
POST /api/v1/image/task
Autenticazione
Authorization: Bearer YOUR_API_KEY
Parametri della richiesta
Obbligatori
Facoltativi
Nota: Il rapporto width:height deve essere uno dei 15 rapporti supportati elencati sopra.
Esempio di richiesta
javascript
MiniMax H3 Image Edit (Modifica delle immagini)
Punto di accesso
POST /api/v1/image/task
Parametri della richiesta
Obbligatori
Facoltativi
Nota: Il rapporto width:height deve essere uno dei 15 rapporti supportati elencati sopra.
Esempio di richiesta
javascript
Esempio di modifica di una singola immagine
javascript
Esempio di composizione di più immagini
javascript
Formato della risposta
Risposta iniziale
json
Risposta al polling
Interrogare periodicamente GET /api/v1/image/{task_id} per verificare lo stato. Le risposte di polling riuscite forniscono gli URL delle immagini generate in data.task_result.images[].url.
Valori di stato
submitted: Attività accettataprocessing: Generazione dell’immagine in corsosucceed: Generazione dell’immagine completatafailed: Generazione dell’immagine non riuscita
Buone pratiche
- Prompt dettagliati: Descrivere il soggetto, l’illuminazione e la composizione, mantenendo i prompt entro 5000 caratteri
- Scelta della risoluzione: Specificare esplicitamente
1k,2ko4kin ogni richiesta - Proporzioni: Utilizzare valori di rapporto abbinati per
widtheheight, oppure omettere entrambi per ottenere1:1 - Qualità della modifica: Fornire 1-16 immagini di riferimento conformi ai requisiti di formato e dimensioni supportati