API di Mage · Modello audio
API Eleven Music
Canzoni ElevenLabs, con o senza voce
POST https://api.mage.space/v1/eleven_music/generateIn 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_id | Nome | Predefinito |
|---|---|---|
| eleven-music-v2.5 | Eleven Music v2.5 | Sì |
Opzioni
Parametri di Eleven Music
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| duration | 10, 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
API Eleven Speech
ElevenLabs v4: voce realistica che puoi dirigere
API Seed Audio
Voci, musica ed effetti sonori da un unico prompt
FAQ
Domande frequenti
Quanto costa l'API Eleven Music?
Qual è l'endpoint dell'API Eleven Music?
Quali modelli Eleven Music posso usare?
Eleven Music supporta immagini di riferimento o personaggi?
Posso usare Eleven Music da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Eleven Music?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.