Vai al contenuto

API di Mage · Modelli

37 modelli di generazione, un'unica API

Tutti i modelli per immagini, video e audio eseguiti dall'API di Mage, con i casi d'uso migliori, i valori model_id e il prezzo con le impostazioni predefinite.

POST https://api.mage.space/v1/{model}/generate

In breve

L'API di Mage esegue 18 modelli per immagini, 15 per video e 4 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 per generazione in Gems.

  • 18Modelli per immagini
  • 15Modelli per video
  • 4Modelli audio
  • 1Una 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.

ModelloIdeale perValori di model_idPrezzo predefinito
AnimaCreato apposta per l'animeanima-v120 Gems ($0.02)
ChromaOpen-weights, basato su Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Prompt lunghi e modifiche con più riferimentiflux2-dev40 Gems ($0.04)
GPT Image 2Prompt precisi e testo leggibilegpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine, in due livelligrok-imagine-image, grok-imagine-image-2.090 Gems ($0.09)
GuavaFotorealismo che sembra una fotografiaguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamVeloce e versatile, con prompt negativihidream-fast20 Gems ($0.02)
Krea 2Estetica splendida in pochi secondikrea-2-turbo20 Gems ($0.02)
MangoLa nostra famiglia di modelli di immagini di puntamango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v442 Gems ($0.042)
MiniMax H3 ImageImmagini native da 16 megapixel, pesi apertiminimax-h3-image15 Gems ($0.015)
MOSS-ImagePrompt lunghi e testo bilingue, pesi apertimoss-image25 Gems ($0.025)
Nano Banana 2Testo nitido e leggibile, fino a 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL con volti e mani corretti6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
SeedreamSeedream, con filtro rigorososeedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.542 Gems ($0.042)
Stable Diffusion v1.5Il classico, a basso costo15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeLo Stable Diffusion che ascolta megliosd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL ottimizzato per il fotorealismo6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageIl modello di immagini più veloce di Magez-image-turbo10 Gems ($0.01)

Modelli per video

Modelli di generazione di video

ModelloIdeale perValori di model_idPrezzo predefinito
BerryVideo fedeli ai tuoi riferimentiberry, berry-2189 Gems ($0.189)
BlueberryFissa il primo e l'ultimo fotogrammablueberry, blueberry-v2360 Gems ($0.36)
CherryLa nostra famiglia di video di puntacherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine, in movimentogrok-imagine-video375 Gems ($0.375)
KiwiVideo di tutti i giorni, senza configurazionekiwi270 Gems ($0.27)
LemonTutte le funzioni video, a un prezzo più amichevolelemon245 Gems ($0.245)
LTX VideoVideo open-weights veloce per iterareltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MagejutsuRifai qualsiasi video mantenendone il movimentomagejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
MelonAnime in movimento, con audio opzionalemelon, melon-pro147 Gems ($0.147)
MiniMax-H3Video open veloce con audio stereominimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
PlumAudio su ogni clip, fino a 2Kplum, plum-max, plum-fast173 Gems ($0.173)
RaspberryPersonaggi che prendono vita da un primo fotogrammaraspberry360 Gems ($0.36)
SeedanceSeedance, con filtro rigorososeedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0, con filtro rigorosowan-3.0245 Gems ($0.245)
Wan Video v2.2Video open-weights con una variante Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Modelli audio

Modelli di generazione audio

ModelloIdeale perValori di model_idPrezzo predefinito
Eleven MusicCanzoni ElevenLabs, con o senza voceeleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: voce realistica che puoi dirigereeleven-v430 Gems ($0.03)
MiniMax Music 3Canzoni complete a partire dal tuo testo, a pesi apertiminimax-music-3125 Gems ($0.125)
Seed AudioVoci, musica ed effetti sonori da un solo promptseed-audio-1.019 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 Gem. I piani di abbonamento e la generazione illimitata nell'app non valgono per le richieste API. L'account deve prima aver effettuato un pagamento andato a buon fine, con un pacchetto di Gem o un piano qualsiasi; i Gem bonus di registrazione funzionano solo nell'app di Mage.
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.

CharactersCommunity