API di Mage · Generazione audio

L'API di generazione audio con IA per voci, musica e suoni

Parlato, narrazione, musica ed effetti sonori da un solo prompt con Seed Audio, con riferimenti vocali e controlli di velocità del parlato, volume e tono.

Ottieni una chiave APILeggi la documentazione dell'API
POST https://api.mage.space/v1/{model}/generate

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.

Modelli

Tutti i modelli audio dell'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.

ModelloIdeale perValori di model_idPrezzo predefinito
Seed AudioVoci, musica ed effetti sonori da un solo promptseed-audio-1.019 Gems ($0.019)

Guida rapida

Genera audio con Seed Audio

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.

cURL
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"
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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

console.log(request.result.url);
Python
# 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

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.

  1. 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.

  2. 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.

  3. 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

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.

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 audio

Narrazione e voice-over

Genera la narrazione per video, spiegazioni e audiolibri, con controlli di velocità del parlato, volume e tono.

Voci coerenti

Salva una clip vocale come riferimento e menzionala con il suo @handle per mantenere la stessa voce in più clip.

Effetti sonori

Crea atmosfere, rumori foley e suoni per l'interfaccia a partire da una descrizione, per giochi e app.

Basi musicali

Produci musica di sottofondo per clip social e pubblicità a partire da un prompt.

Colonne sonore per video generati

Abbina Seed Audio all'API video per aggiungere l'audio alle clip dei modelli senza sonoro.

Agenti che parlano

Lascia che Claude, ChatGPT o il tuo agente producano audio tramite il server MCP o l'API REST.

FAQ

Domande frequenti

L'API audio può fare sintesi vocale (text-to-speech)?

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.

Quanto può durare l'audio generato?

Seed Audio genera clip fino a 120 secondi.

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.

Ottieni una chiave APILeggi la documentazione dell'API

Correlati