Vai al contenuto

API di Mage · Modello audio

API Eleven Speech

ElevenLabs v4: voce realistica che puoi dirigere

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

In breve

L'API Eleven Speech esegue Eleven v4 tramite Mage su POST https://api.mage.space/v1/eleven_speech/generate. Una richiesta con le impostazioni predefinite costa 30 Gems (circa 0,03 $), senza abbonamento. Eleven Speech non supporta le menzioni @handle.

  • AudioOutput
  • 1Variante
  • 30Gems per clip, predefinito
  • $0.03Circa, in USD

Panoramica

Cosa fa l'API Eleven Speech

Sintesi vocale ElevenLabs v4 con 16 voci e più di 90 lingue, diretta riga per riga con tag audio come [whispers] o [laughs].

La sintesi vocale espressiva di ElevenLabs in oltre 90 lingue, in un MP3 lungo quanto il testo. I tag audio tra parentesi quadre dirigono l'interpretazione e aggiungono effetti sonori: [whispers], [laughs], [sarcastic], [door slams].

Genera partendo solo dal prompt.

Guida rapida

Chiama l'API Eleven Speech

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

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

Modelli

Valori model_id di Eleven Speech

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

model_idNomePredefinito
eleven-v4Eleven v4Sì

Opzioni

Parametri di Eleven Speech

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

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

Regole

Cosa impone l'API Eleven Speech

  • Il prompt è il testo da pronunciare, al massimo 5000 caratteri, tag audio inclusi.
  • `voice` è una tra darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt.
  • `stability` va da 0 (espressivo) a 1 (stabile).

Altri modelli audio

Altre API di generazione audio su Mage

  • Audio · da 19 Gems

    API Seed Audio

    Voci, musica ed effetti sonori da un unico prompt

  • Audio · da 113 Gems

    Eleven Music API

    Canzoni ElevenLabs, con o senza voce

FAQ

Domande frequenti

Quanto costa l'API di Eleven Speech?
Una richiesta a Eleven Speech con le impostazioni predefinite (Eleven v4) costa 30 Gems, circa 0,03 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla policy sui contenuti di Mage no.
Qual è l'endpoint dell'API di Eleven Speech?
POST https://api.mage.space/v1/eleven_speech/generate con un header Authorization: Bearer che contiene la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.
Quali modelli di Eleven Speech posso usare?
eleven-v4 (Eleven v4). Il modello predefinito è Eleven v4.
Eleven Speech supporta immagini di riferimento o personaggi?
Eleven Speech non accetta immagini, video o audio come input. Eleven Speech non accetta menzioni @handle.
Posso usare Eleven Speech da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Eleven Speech 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 Speech?
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.