Passer au contenu

API Mage · Modèle audio

API Eleven Speech

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

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

En un coup d’œil

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

  • AudioSortie
  • 1Variante
  • 30Gems par clip, par défaut
  • $0.03Environ, en USD

Présentation

Ce que fait l'API Eleven Speech

Synthèse vocale ElevenLabs v4 avec 16 voix et plus de 90 langues, dirigée réplique par réplique grâce à des balises audio comme [whispers] ou [laughs].

La synthèse vocale expressive d'ElevenLabs dans plus de 90 langues, en MP3 aussi long que le texte. Des balises audio entre crochets dirigent l'interprétation et ajoutent des effets sonores : [whispers], [laughs], [sarcastic], [door slams].

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

Démarrage rapide

Appeler l'API Eleven Speech

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_speech/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
  "model_id": "eleven-v4"
}' | 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_speech', {
  prompt: 'Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.',
  model_id: 'eleven-v4',
});

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_speech", {
    "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
    "model_id": "eleven-v4",
})

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

Modèles

Valeurs model_id d'Eleven Speech

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

model_idNomPar défaut
eleven-v4Eleven v4Oui

Options

Paramètres d'Eleven Speech

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

ChampValeurs
voicedarian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt

Règles

Ce que l'API Eleven Speech impose

  • Le prompt est le texte à prononcer, avec 5000 caractères au maximum, balises audio comprises.
  • `voice` vaut l'une de ces valeurs : darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt.
  • `stability` va de 0 (expressif) à 1 (stable).

Plus de modèles audio

Autres API de génération audio sur Mage

  • Audio · à partir de 19 Gems

    API Seed Audio

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

  • Audio · à partir de 113 Gems

    Eleven Music API

    Des chansons ElevenLabs, avec ou sans voix

FAQ

Questions fréquentes

Combien coûte l'API Eleven Speech ?
Une requête Eleven Speech avec les réglages par défaut (Eleven v4) coûte 30 Gems, soit environ 0,03 $. Les 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 ; celle que la politique de contenu de Mage bloque ne l'est pas.
Quel est l'endpoint de l'API Eleven Speech ?
POST https://api.mage.space/v1/eleven_speech/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut une status_url à interroger pour obtenir le résultat.
Quels modèles Eleven Speech puis-je appeler ?
eleven-v4 (Eleven v4). Le modèle par défaut est Eleven v4.
Eleven Speech prend-il en charge les images de référence ou les personnages ?
Eleven Speech n'accepte aucune entrée image, vidéo ou audio. Eleven Speech n'accepte pas les mentions @handle.
Puis-je utiliser Eleven Speech depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Eleven Speech par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats Eleven Speech 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.