In breve
L'API di Mage esegue 15 modelli per immagini, 12 per video e 1 per audio su https://api.mage.space/v1/{model}/generate. Ogni modello usa la stessa chiave, lo stesso ciclo di richiesta e gli stessi nomi di campo, e si paga a generazione in Gems.
15
Modelli per immagini
12
Modelli per video
1
Modelli audio
1
Una chiave API per tutti
Modelli per immagini
Modelli di generazione di immagini
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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, in tre livelli di qualità | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | Testo nitido e leggibile, fino a 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL con volti e mani corretti | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
Modelli per video
Modelli di generazione di video
| Modello | Ideale per | Valori di model_id | Prezzo predefinito |
|---|---|---|---|
| Berry | Video fedeli ai tuoi riferimenti | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fissa il primo e l'ultimo fotogramma | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | La nostra famiglia di video di punta | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, in movimento | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video di tutti i giorni, senza configurazione | kiwi | 270 Gems ($0.27) |
| Lemon | Tutte le funzioni video, a un prezzo più amichevole | lemon | 245 Gems ($0.245) |
| LTX Video | Video open-weights veloce per iterare | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime in movimento, con audio opzionale | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Video open veloce con audio stereo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Audio su ogni clip, fino a 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Personaggi che prendono vita da un primo fotogramma | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Video open-weights con una variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Modelli audio
Modelli di generazione audio
| Modello | Ideale per | Valori di model_id | Prezzo predefinito |
|---|---|---|---|
| Seed Audio | Voci, musica ed effetti sonori da un solo prompt | seed-audio-1.0 | 19 Gems ($0.019) |
FAQ
Domande frequenti
Quanto costa l'API di Mage?
Non ci sono abbonamenti né canoni mensili. Ogni generazione si paga in Gems al prezzo indicato per il suo modello, e 1.000 Gems costano 1 $ con il pacchetto standard. La pagina di ogni modello riporta il prezzo con le impostazioni predefinite e ogni risposta indica l'addebito esatto. Se una generazione fallisce, viene rimborsata; se la blocca la content policy di Mage, no. Una richiesta che il tuo saldo non copre viene rifiutata prima di qualsiasi addebito.
Mi serve un abbonamento a Mage per usare l'API?
No. L'API funziona solo con i Gems. I piani di abbonamento e la generazione illimitata nell'app non valgono per le richieste API, quindi qualsiasi account Mage con dei Gems può usarla.
Posso usare a fini commerciali i contenuti generati con l'API?
Sì. I contenuti che crei con Mage, anche tramite l'API e il server MCP, possono essere usati a fini commerciali. L'attribuzione è gradita ma non obbligatoria.
Quali sono i limiti di richieste?
Un account può avere fino a 20 generazioni in coda o in corso contemporaneamente. Un invio oltre questo limite viene rifiutato con errore 429 e non costa nulla. Scrivi a [email protected] per aumentare il limite in base al tuo caso d'uso.
Il mio agente AI può usare l'API di Mage?
Sì. Gli agenti possono chiamare l'API REST con una chiave oppure collegarsi al server MCP di Mage, che offre a Claude, ChatGPT, Claude Code, Grok e Cursor sedici strumenti già pronti per scegliere un modello, calcolare il prezzo, generare e recuperare il risultato. Vedi il server MCP.
Esiste un SDK per l'API di Mage?
Sì. Il pacchetto ufficiale @mage-space/sdk su npm e mage-space su PyPI sono open source e tipizzati per ogni modello. Inviano la richiesta, attendono il risultato, riprovano in sicurezza e caricano i file per te. Chi usa ComfyUI può installare il pacchetto di nodi comfyui-mage. Vedi gli SDK di Mage.
Uso già un'altra API di generazione. Cosa devo cambiare?
Punta il tuo client a https://api.mage.space/v1, invia la tua chiave Mage come Bearer token e associa i tuoi campi a quelli della pagina del modello: prompt, aspect_ratio, resolution, duration e model_id funzionano allo stesso modo su tutti i modelli Mage. Le richieste sono asincrone: invia la richiesta e poi interroga status_url a intervalli regolari.
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.