Una chiave, tutti i modelli
28 modelli per immagini, video e audio con un'unica API REST e un unico saldo di Gems. Cambi modello modificando il percorso dell'URL.
In breve
Mage offre agli sviluppatori un'API REST su https://api.mage.space/v1 e un server MCP remoto su https://mcp.mage.space/mcp. Entrambi usano gli stessi 28 modelli per immagini, video e audio, inclusi Mango 3 e Cherry 2 Pro, esclusivi di Mage, con un solo account, e ogni generazione si paga in Gems, senza abbonamento.
28
Modelli
3
Tipi di media
16
Strumenti MCP
$0
Costo mensile
Come iniziare
Usala dal codice, dal tuo assistente o da ComfyUI
API REST
L'API di Mage
Invia generazioni dal tuo codice con una chiave. Richieste asincrone, nuovi tentativi idempotenti, upload fino a 100 MB e 20 generazioni in corso contemporaneamente.
SDK
SDK per TypeScript e Python
Client ufficiali e tipizzati che inviano la richiesta, attendono il risultato, riprovano in sicurezza e caricano file in poche righe.
Server MCP
Il server MCP di Mage
Collega Claude, ChatGPT, Claude Code, Grok o Cursor con un accesso e chiedi immagini, video e audio con parole semplici.
ComfyUI
Mage per ComfyUI
Mango, Cherry, Seed Audio e tutti gli altri modelli di Mage come nodi ComfyUI. Nessuna GPU, nessun download di modelli.
Per tipo di media
API di generazione
15 modelli
API per generare immagini con l'IA
Da testo a immagine, modifica e personaggi coerenti fino a 4K.
12 modelli
API per generare video con l'IA
Da testo a video, da immagine a video, fotogrammi, riferimenti e suono.
1 modello
API per generare audio con l'IA
Voci, narrazione, musica ed effetti sonori a partire da un prompt.
Guida rapida
La tua prima generazione
Crea una chiave in API → API Keys, esportala come MAGE_API_KEY ed esegui uno di questi esempi.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v3"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
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.
MCP
Mage nel tuo assistente IA
Mage in Claude
Genera immagini, video e audio in Claude sul web, nell'app desktop, nelle app mobile e in Cowork.
Mage in ChatGPT
Genera immagini, video e audio in ChatGPT come app MCP personale.
Mage in Claude Code
Genera immagini, video e audio con Claude Code, nel terminale e nell'editor.
Mage in Grok
Genera immagini, video e audio in Grok come connettore personalizzato.
Mage in Cursor
Genera immagini, video e audio nella modalità Agent di Cursor.
Modelli
Modelli in evidenza
Immagine · da 40 Gems
API Flux 2
Prompt lunghi e modifiche con più riferimenti
Immagine · da 9 Gems
API GPT Image 2
Prompt precisi e testo leggibile
Immagine · da 37 Gems
API Guava
Un fotorealismo che sembra una vera fotografia
Immagine · da 135 Gems
API Mango
La nostra famiglia di modelli immagine di punta
Immagine · da 68 Gems
API Nano Banana 2
Testo nitido e leggibile, fino a 4K
Video · da 618 Gems
API Cherry
La nostra famiglia di modelli video di punta
Video · da 245 Gems
API Lemon
Tutte le funzioni video, a un prezzo più accessibile
Video · da 338 Gems
API Plum
Audio su ogni clip, fino a 2K
Audio · da 19 Gems
API Seed Audio
Voci, musica ed effetti sonori da un unico prompt
Pensata per la produzione
Cosa ottiene ogni richiesta all'API di Mage
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.
FAQ
Domande frequenti
Cos'è l'API di Mage?
L'API di Mage è un'API REST su https://api.mage.space/v1 per generare immagini, video e audio con 28 modelli direttamente dal tuo codice. Le richieste sono asincrone e si pagano per generazione in Gems.
Cos'è il server MCP di Mage?
Un server Model Context Protocol remoto su https://mcp.mage.space/mcp che permette agli assistenti AI di generare immagini, video e audio sul tuo account Mage. Offre all'assistente 16 strumenti per scegliere un modello, indicare il prezzo, generare, attendere il risultato e usare i tuoi personaggi, riferimenti e la tua cronologia salvati.
Mi serve una chiave API per usare il server MCP?
No. Claude, ChatGPT, Grok, Cursor e Claude Code si collegano accedendo a Mage tramite OAuth. La chiave API è facoltativa e serve per configurazioni headless, come la CI.
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.