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
L'API di generazione audio di Mage esegue Seed Audio su https://api.mage.space/v1/seed_audio/generate. Invia un prompt di testo, se vuoi con riferimenti vocali o un'immagine, e ricevi un file audio fino a 120 secondi con voci, musica o effetti sonori. Ogni clip si paga in Gems, senza abbonamento.
1
modelli audio
$0.019
Opzione predefinita più economica, per clip
20
Generazioni simultanee
$0
Costo mensile
Modelli
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 |
|---|---|---|---|
| Seed Audio | Voci, musica ed effetti sonori da un solo prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Guida rapida
Imposta MAGE_API_KEY, invia la richiesta e fai polling fino al completamento. Sostituisci seed_audio nell'URL con uno qualsiasi dei modelli qui sopra.
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])Come funziona
Tutti i modelli condividono un unico schema di autenticazione, un unico ciclo di vita asincrono delle richieste e gli stessi nomi dei campi.
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 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.
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
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.
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.
Con le chiavi di idempotenza, un nuovo invio restituisce la richiesta originale senza addebitarti di nuovo.
Salva un personaggio o un riferimento una volta sola, poi scrivi @handle in qualsiasi prompt per usarlo con tutti i modelli che lo supportano.
Invia input di immagini, video e audio come URL o data URL, oppure carica file fino a 100 MB con un upload firmato.
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
Genera la narrazione per video, spiegazioni e audiolibri, con controlli di velocità del parlato, volume e tono.
Salva una clip vocale come riferimento e menzionala con il suo @handle per mantenere la stessa voce in più clip.
Crea atmosfere, rumori foley e suoni per l'interfaccia a partire da una descrizione, per giochi e app.
Produci musica di sottofondo per clip social e pubblicità a partire da un prompt.
Abbina Seed Audio all'API video per aggiungere l'audio alle clip dei modelli senza sonoro.
Lascia che Claude, ChatGPT o il tuo agente producano audio tramite il server MCP o l'API REST.
FAQ
Sì. Seed Audio legge un testo con una voce descritta, o con un riferimento vocale salvato, e offre impostazioni di velocità del parlato, volume e tono. Dallo stesso campo prompt genera anche musica ed effetti sonori.
Seed Audio genera clip fino a 120 secondi.
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.
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.
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.
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.
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.
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.
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.
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.