API Mage · Generazione di immagini
L'API di intelligenza artificiale per generare immagini con ogni modello
Da testo a immagine, modifica di immagini e personaggi coerenti con 18 modelli, incluso Mango 4, il modello di punta di Mage, con una sola chiave e un solo saldo.
POST https://api.mage.space/v1/{model}/generateIn breve
L'API di generazione di immagini di Mage è un'API REST su https://api.mage.space/v1 che esegue 18 modelli da testo a immagine e di modifica immagini, tra cui Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 e Krea 2. Invii un prompt con POST a /{model}/generate, controlli lo stato della richiesta e scarichi l'immagine. Ogni immagine si paga in Gems, senza abbonamento.
- 18modelli di immagini
- $0.009Prezzo predefinito più basso, per immagine
- 20Generazioni simultanee
- $0Costo mensile
Modelli
Tutti i modelli di immagini nell'API di Mage
I prezzi sono per generazione, in Gems. 1.000 Gems costano 1 $ con il pacchetto standard, e i pacchetti più grandi aggiungono Gems bonus. Il prezzo dipende da modello, risoluzione e durata; qui è mostrato il prezzo con le impostazioni predefinite, e ogni risposta indica l'addebito esatto in billing.gems_charged. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
| Modello | Ideale per | Valori di model_id | Prezzo predefinito |
|---|---|---|---|
| Anima | Creato apposta per l'anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, basato su Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Prompt lunghi e modifiche con più riferimenti | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompt precisi e testo leggibile | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, in due livelli | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Fotorealismo che sembra una fotografia | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Veloce e versatile, con prompt negativi | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Estetica splendida in pochi secondi | krea-2-turbo | 20 Gems ($0.02) |
| Mango | La nostra famiglia di modelli di immagini di punta | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Immagini native da 16 megapixel, pesi aperti | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Prompt lunghi e testo bilingue, pesi aperti | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Testo nitido e leggibile, fino a 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL con volti e mani corretti | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, con filtro rigoroso | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | Il classico, a basso costo | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Lo Stable Diffusion che ascolta meglio | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL ottimizzato per il fotorealismo | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Il modello di immagini più veloce di Mage | z-image-turbo | 10 Gems ($0.01) |
Guida rapida
Genera un'immagine con Anima v1
Imposta MAGE_API_KEY, invia la richiesta e controlla lo stato finché non è completata. Sostituisci anima nell'URL con uno qualsiasi dei modelli qui sopra.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])Come funziona
Dalla chiave API al media finito in tre chiamate
Tutti i modelli condividono un unico schema di autenticazione, un unico ciclo di vita asincrono delle richieste e gli stessi nomi dei campi.
Crea una chiave API
Accedi a Mage, apri API → API Keys e crea una chiave. Inizia con mage_sk_ e viene mostrata una sola volta. Un account può avere 10 chiavi attive.
Invia una generazione
Invia con POST un corpo JSON a https://api.mage.space/v1/{model}/generate con un header Authorization: Bearer. La risposta arriva subito con un request_id, uno status e uno status_url. Aggiungi un header Idempotency-Key così un nuovo tentativo non ti farà mai pagare due volte.
Controlla lo stato e scarica
Interroga status_url finché lo stato non è completed, failed o cancelled. Una richiesta completata contiene result.url con il file di immagine, video o audio, conservato per 30 giorni.
Pensata per la produzione
Cosa ottiene ogni richiesta all'API di Mage
Una chiave, tutti i modelli
37 modelli per immagini, video e audio dietro una sola API REST e un solo saldo di Gems. Cambi modello modificando il percorso dell'URL.
Paghi per generazione
Nessun abbonamento e nessuna spesa minima. Acquisti Gems e ogni richiesta costa il prezzo indicato. Se una generazione fallisce, ti viene rimborsata, a meno che non sia stata bloccata dalla content policy di Mage.
Nuovi tentativi sicuri
Con le chiavi di idempotenza, un nuovo invio restituisce la richiesta originale senza addebitarti di nuovo.
Personaggi coerenti
Salva un personaggio o un riferimento una volta sola, poi scrivi @handle in qualsiasi prompt per usarlo con tutti i modelli che lo supportano.
File di grandi dimensioni
Invia input di immagini, video e audio come URL o data URL, oppure carica file fino a 100 MB con un upload firmato.
20 generazioni in parallelo
Ogni account può eseguire 20 generazioni contemporaneamente e il limite può essere aumentato in base alle tue esigenze. Le richieste rifiutate non vengono mai addebitate.
Casi d'uso
Cosa creano gli sviluppatori con l'API di immagini
Immagini per prodotti e marketing
Crea al volo foto di prodotto, varianti di annunci e post per i social, con testo leggibile grazie a GPT Image 2.6 o Nano Banana 2.
Personaggi coerenti
Salva un personaggio una volta e mantieni lo stesso volto in un'intera serie con Mango 4, Guava 2 Pro e altri modelli che supportano le menzioni @handle.
Pipeline di editing delle immagini
Invia un'immagine di partenza con un'istruzione per cambiare esattamente ciò che chiedi e lasciare invariato il resto.
App e giochi
Genera avatar, sticker, carte e scene dentro il tuo prodotto senza ospitare nemmeno una GPU.
Ritratti fotorealistici
Guava 2 Pro crea ritratti, scatti di moda e lifestyle con pelle, tessuti e luce fedeli alla realtà.
Bozze veloci su larga scala
Z-Image Turbo e Krea 2 tengono i prezzi bassi per miniature e prime versioni in grandi volumi.
FAQ
Domande frequenti
Qual è la migliore API per generare immagini con l'IA?
L'API per le immagini supporta l'editing e le immagini di riferimento?
Quali risoluzioni supporta l'API per le immagini?
Quanto costa l'API di Mage?
Mi serve un abbonamento a Mage per usare l'API?
Posso usare a fini commerciali i contenuti generati con l'API?
Quali sono i limiti di richieste?
Il mio agente AI può usare l'API di Mage?
Esiste un SDK per l'API di Mage?
Uso già un'altra API di generazione. Cosa devo cambiare?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.