Salta ai contenuti

Comandi ElevenLabs

Comandi e workflow completi di sintesi vocale AI di ElevenLabs per text-to-speech e generazione vocale.

Autenticazione API

ComandoDescrizione
curl -H "xi-api-key: <api-key>" <endpoint>Autenticazione API
export ELEVEN_API_KEY=<key>Imposta variabile di ambiente
elevenlabs auth loginAccedi all’account
elevenlabs auth logoutEsci dall’account
elevenlabs auth statusControlla lo stato di autenticazione

API Text-to-Speech

EndpointDescrizione
POST /v1/text-to-speech/{voice_id}Genera speech
POST /v1/text-to-speech/{voice_id}/streamFlusso di parola
GET /v1/voicesElenca voci disponibili
GET /v1/voices/{voice_id}Ottieni dettagli voce
POST /v1/voices/addAggiungi voce personalizzata

Gestione Vocale

ComandoDescrizione
GET /v1/voicesElenca tutte le voci
GET /v1/voices/{voice_id}Ottieni informazioni vocali
DELETE /v1/voices/{voice_id}Elimina voce personalizzata
POST /v1/voices/{voice_id}/editModifica impostazioni voce
GET /v1/voices/settingsOttieni impostazioni vocali

Generazione Vocale

ComandoDescrizione
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM" -H "xi-api-key: <key>" -H "Content-Type: application/json" -d '{"text": "Hello world"}'Generazione di discorsi di base
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM/stream" -H "xi-api-key: <key>"Streaming speech

Python SDK

ComandoDescrizione
pip install elevenlabsInstalla Python SDK
from elevenlabs import generate, playImporta SDK
generate(text="Hello", voice="Bella")Genera speech
play(audio)Riproduci audio generato
save(audio, "output.mp3")Salva file audio

Clonazione Vocale

ComandoDescrizione
POST /v1/voices/addClona voce da campioni
POST /v1/voices/{voice_id}/samplesAggiungi campioni vocali
DELETE /v1/voices/{voice_id}/samples/{sample_id}Elimina campione vocale
GET /v1/voices/{voice_id}/samplesElenca campioni vocali

Impostazioni Vocali

ParametroDescrizione
stabilityCoerenza vocale (0.0-1.0)
similarity_boostSomiglianza vocale (0.0-1.0)
styleStile di parlata (0.0-1.0)
use_speaker_boostMigliora la somiglianza degli speaker

Formati Audio

FormatoDescrizione
mp3_44100_128MP3 44.1kHz 128kbps
mp3_22050_32MP3 22.05kHz 32kbps
pcm_16000PCM 16 kHz
pcm_22050PCM 22,05 kHz
pcm_24000PCM 24kHz
pcm_44100PCM 44.1kHz

Voci Predefinite

Voice IDNomeDescrizione
21m00Tcm4TlvDq8ikWAMRachelFemmina americana
AZnzlk1XvdvUeBnXmlldDomiFemmina americana
EXAVITQu4vr4xnSDxMaLBellaFemmina americana
ErXwobaYiN019PkySvjVAntoniMaschio americano
MF3mGyEYCl7XYWbV9V6OElliAmericana femmina
TxGEqnHWrfWFTfGW9XjXJoshMaschio americano
VR6AewLTigWG4xSOukaGArnoldMaschio americano
pNInz6obpgDQGcFmaJgBAdamoMaschio americano

Node.js SDK

ComandoDescrizione
npm install elevenlabsInstallare Node.js SDK
const { ElevenLabsAPI } = require('elevenlabs')Importa SDK
const client = new ElevenLabsAPI({ apiKey: 'key' })Inizializza client
client.textToSpeech.generate()Genera speech

Streaming Audio

ComandoDescrizione
POST /v1/text-to-speech/{voice_id}/streamTrasmetti audio
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3Stream verso file

Funzionalità Voice Lab

FunzionalitàDescrizione
Voice DesignCreare voci sintetiche
Voice CloningClonare voci esistenti
Professional CloningClonazione vocale di alta qualità
Voice LibrarySfoglia raccolta vocale

Limiti di Utilizzo API

PianoCaratteri/MeseRichieste Concorrenti
Free10.0002
Starter30.0003
Creator100.0005
Pro500.00010
Scale2.000.00025

Gestione degli Errori

Codice di ErroreDescrizione
400Richiesta Non Valida
401Non autorizzato
403Vietato
404Non trovato
422Unprocessable Entity
429Troppe Richieste
500Errore Interno del Server

Parametri Avanzati

ParametroDescrizione
model_idModello TTS da utilizzare
voice_settingsConfigurazione vocale
pronunciation_dictionary_locatorsPronunce personalizzate
seedGenerazione riproducibile

Configurazione Webhook

ComandoDescrizione
POST /v1/webhooksCrea webhook
GET /v1/webhooksElenca webhook
DELETE /v1/webhooks/{webhook_id}Elimina webhook
PUT /v1/webhooks/{webhook_id}Aggiorna webhook

Progetti e Doppiaggio

ComandoDescrizione
POST /v1/projectsCrea progetto
GET /v1/projectsElenca progetti
POST /v1/dubbingCrea progetto di doppiaggio
GET /v1/dubbing/{dubbing_id}Ottieni stato doppiaggio

Analytics di Utilizzo

ComandoDescrizione
GET /v1/user/subscriptionOttieni informazioni sull’abbonamento
GET /v1/userOttieni informazioni utente
GET /v1/usage/character-statsOttieni statistiche di utilizzo

Strumento CLI

ComandoDescrizione
elevenlabs --helpMostra aiuto
elevenlabs tts --text "Hello" --voice RachelGenera speech
elevenlabs voices listElenco voci
elevenlabs voices clone --name "MyVoice"Clonare voce
CodiceDescrizione
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1")Generazione di base
play(audio)Riproduci audio
save(audio, "hello.mp3")Salva su file
CodiceDescrizione
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" })Genera audio
fs.writeFileSync("audio.mp3", audio)Salva su file
PassoDescrizione
1. Upload samplesFornire campioni vocali
2. Train modelAI impara i modelli vocali
3. Test generationVerificare la qualità vocale
4. Fine-tune settingsRegola i parametri
5. Deploy voiceUtilizzare in produzione
PraticaDescrizione
Clear audio samplesRegistrazioni di alta qualità
Diverse samplesVarie emozioni/stili
Consistent speakerStessa persona durante tutto il tempo
Proper length1-5 minuti totali
Good microphoneRegistrazione professionale
PiattaformaIntegrazione
Discord BotGenerazione messaggio vocale
PodcastNarrazione automatizzata
E-learningDoppiaggi del corso
GamingVoci dei personaggi
AccessibilitySintesi vocale per persone con disabilità visive
ProblemaSoluzione
Poor voice qualityMigliora la qualità del campione
Rate limit exceededAggiorna il piano o aspetta
Authentication failedControlla chiave API
Voice not foundVerifica ID voce
Audio distortionRegola impostazioni voce
VariabileDescrizione
ELEVEN_API_KEYChiave di autenticazione API
ELEVEN_API_URLURL base dell’API
ELEVEN_TIMEOUTTimeout della richiesta
FileDescrizione
.elevenlabs.jsonFile di configurazione
voices.jsonDefinizioni vocali
settings.jsonImpostazioni predefinite
MetricaDescrizione
----------------------
Characters usedUtilizzo mensile
API callsConteggio richieste
Voice generationsAudio creato
Error rateRichieste fallite