Passer au contenu
PlaygroundDocumentationObtenir une clé API

API Mage · Modèle audio

API Eleven Music

Des chansons ElevenLabs, avec ou sans voix

Obtenir une clé d'APIEssaie Eleven Music dans le playground
POST https://api.mage.space/v1/eleven_music/generate

En un coup d’œil

L'API Eleven Music exécute Eleven Music v2.5 via Mage sur POST https://api.mage.space/v1/eleven_music/generate. Une requête avec les réglages par défaut coûte 113 Gems (environ 0,113 $), sans abonnement. Eleven Music n'accepte pas les mentions @handle.

  • AudioSortie
  • 1Variante
  • 113Gems par clip, par défaut
  • $0.113Environ, en USD

Présentation

Ce que fait l'API Eleven Music

Eleven Music par ElevenLabs : des chansons avec paroles et voix, ou des instrumentaux, à partir d'une description, exactement à la durée que tu choisis, jusqu'à 5 minutes.

Le modèle musical d'ElevenLabs : des chansons avec voix ou instrumentales, en MP3 de la durée exacte demandée. Un prompt qui cite un artiste ou des paroles protégées par le droit d'auteur est refusé par ElevenLabs ; la requête échoue et elle est remboursée.

Il génère à partir du prompt seul.

Démarrage rapide

Appeler l'API Eleven Music

Définis MAGE_API_KEY, envoie ta requête à /eleven_music/generate, puis interroge status_url jusqu'à ce qu'elle soit terminée.

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"])

Modèles

Valeurs model_id d'Eleven Music

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
eleven-music-v2.5Eleven Music v2.5Oui

Options

Paramètres d'Eleven Music

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

ChampValeurs
duration10, 30, 60, 120, 180, 300

Règles

Ce que l'API Eleven Music impose

  • Le prompt décrit la chanson, avec 2000 caractères au maximum.

Plus de modèles audio

Autres API de génération audio sur Mage

  • Audio · à partir de 30 Gems

    API Eleven Speech

    ElevenLabs v4 : une voix réaliste que tu peux diriger

  • Audio · à partir de 19 Gems

    API Seed Audio

    Voix, musique et effets sonores à partir d'un seul prompt

FAQ

Questions fréquentes

Combien coûte l'API Eleven Music ?
Une requête Eleven Music avec les réglages par défaut (Eleven Music v2.5) coûte 113 Gems, soit environ 0,113 $. D'autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; une génération bloquée par la politique de contenu de Mage ne l'est pas.
Quel est l'endpoint de l'API Eleven Music ?
POST https://api.mage.space/v1/eleven_music/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles Eleven Music puis-je appeler ?
eleven-music-v2.5 (Eleven Music v2.5). Le modèle par défaut est Eleven Music v2.5.
Eleven Music accepte-t-il des images de référence ou des personnages ?
Eleven Music n'accepte aucune entrée image, vidéo ou audio. Eleven Music n'accepte pas les mentions @handle.
Puis-je utiliser Eleven Music depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Eleven Music par son nom. Ton assistant lit ses options avec get_model et t'indique le prix avant de générer.
Combien de temps les résultats Eleven Music sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.

Obtenir une clé d'APIEssaie Eleven Music dans le playground