Vai al contenuto

API di Mage · Modello audio

API Eleven Music

Canzoni ElevenLabs, con o senza voce

POST https://api.mage.space/v1/eleven_music/generate

In breve

L'API Eleven Music esegue Eleven Music v2.5 tramite Mage su POST https://api.mage.space/v1/eleven_music/generate. Una richiesta con le impostazioni predefinite costa 113 Gems (circa 0,113 $), senza abbonamento. Eleven Music non supporta le menzioni @handle.

  • AudioOutput
  • 1Variante
  • 113Gems per clip, predefinito
  • $0.113Circa, in USD

Panoramica

Cosa fa l'API Eleven Music

Eleven Music di ElevenLabs: canzoni con testo e voce, oppure strumentali, a partire da una descrizione, esattamente della durata che scegli, fino a 5 minuti.

Il modello musicale di ElevenLabs: canzoni con voce o strumentali, in un MP3 della durata esatta richiesta. ElevenLabs rifiuta un prompt che nomina un artista o cita testi protetti da copyright; la richiesta non va a buon fine e viene rimborsata.

Genera partendo solo dal prompt.

Guida rapida

Chiama l'API Eleven Music

Imposta MAGE_API_KEY, invia la richiesta a /eleven_music/generate e fai polling su status_url finché la richiesta non è completata.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
  "duration": "30",
  "model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
  prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
  duration: '30',
  model_id: 'eleven-music-v2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("eleven_music", {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
    "duration": "30",
    "model_id": "eleven-music-v2.5",
})

print(request["result"]["url"])

Modelli

Valori model_id di Eleven Music

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

model_idNomePredefinito
eleven-music-v2.5Eleven Music v2.5Sì

Opzioni

Parametri di Eleven Music

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

CampoValori
duration10, 30, 60, 120, 180, 300

Regole

Cosa impone l'API Eleven Music

  • Il prompt descrive la canzone, al massimo 2000 caratteri.

Altri modelli audio

Altre API di generazione audio su Mage

  • Audio · da 30 Gems

    API Eleven Speech

    ElevenLabs v4: voce realistica che puoi dirigere

  • Audio · da 19 Gems

    API Seed Audio

    Voci, musica ed effetti sonori da un unico prompt

FAQ

Domande frequenti

Quanto costa l'API Eleven Music?
Una richiesta Eleven Music con le impostazioni predefinite (Eleven Music v2.5) costa 113 Gems, circa 0,113 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
Qual è l'endpoint dell'API Eleven Music?
POST https://api.mage.space/v1/eleven_music/generate con un header Authorization: Bearer che contiene la tua chiave API Mage. La risposta include uno status_url su cui fare polling per ottenere il risultato.
Quali modelli Eleven Music posso usare?
eleven-music-v2.5 (Eleven Music v2.5). Quello predefinito è Eleven Music v2.5.
Eleven Music supporta immagini di riferimento o personaggi?
Eleven Music non accetta input di immagini, video o audio. Eleven Music non supporta le menzioni @handle.
Posso usare Eleven Music da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Eleven Music per nome. Il tuo assistente legge le opzioni con get_model e ti dice il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Eleven Music?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.