Comandi e workflow completi di sintesi vocale AI di ElevenLabs per text-to-speech e generazione vocale.
Autenticazione API
| Comando | Descrizione |
|---|
curl -H "xi-api-key: <api-key>" <endpoint> | Autenticazione API |
export ELEVEN_API_KEY=<key> | Imposta variabile di ambiente |
elevenlabs auth login | Accedi all’account |
elevenlabs auth logout | Esci dall’account |
elevenlabs auth status | Controlla lo stato di autenticazione |
API Text-to-Speech
| Endpoint | Descrizione |
|---|
POST /v1/text-to-speech/{voice_id} | Genera speech |
POST /v1/text-to-speech/{voice_id}/stream | Flusso di parola |
GET /v1/voices | Elenca voci disponibili |
GET /v1/voices/{voice_id} | Ottieni dettagli voce |
POST /v1/voices/add | Aggiungi voce personalizzata |
Gestione Vocale
| Comando | Descrizione |
|---|
GET /v1/voices | Elenca tutte le voci |
GET /v1/voices/{voice_id} | Ottieni informazioni vocali |
DELETE /v1/voices/{voice_id} | Elimina voce personalizzata |
POST /v1/voices/{voice_id}/edit | Modifica impostazioni voce |
GET /v1/voices/settings | Ottieni impostazioni vocali |
Generazione Vocale
| Comando | Descrizione |
|---|
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
| Comando | Descrizione |
|---|
pip install elevenlabs | Installa Python SDK |
from elevenlabs import generate, play | Importa SDK |
generate(text="Hello", voice="Bella") | Genera speech |
play(audio) | Riproduci audio generato |
save(audio, "output.mp3") | Salva file audio |
Clonazione Vocale
| Comando | Descrizione |
|---|
POST /v1/voices/add | Clona voce da campioni |
POST /v1/voices/{voice_id}/samples | Aggiungi campioni vocali |
DELETE /v1/voices/{voice_id}/samples/{sample_id} | Elimina campione vocale |
GET /v1/voices/{voice_id}/samples | Elenca campioni vocali |
Impostazioni Vocali
| Parametro | Descrizione |
|---|
stability | Coerenza vocale (0.0-1.0) |
similarity_boost | Somiglianza vocale (0.0-1.0) |
style | Stile di parlata (0.0-1.0) |
use_speaker_boost | Migliora la somiglianza degli speaker |
| Formato | Descrizione |
|---|
mp3_44100_128 | MP3 44.1kHz 128kbps |
mp3_22050_32 | MP3 22.05kHz 32kbps |
pcm_16000 | PCM 16 kHz |
pcm_22050 | PCM 22,05 kHz |
pcm_24000 | PCM 24kHz |
pcm_44100 | PCM 44.1kHz |
Voci Predefinite
| Voice ID | Nome | Descrizione |
|---|
21m00Tcm4TlvDq8ikWAM | Rachel | Femmina americana |
AZnzlk1XvdvUeBnXmlld | Domi | Femmina americana |
EXAVITQu4vr4xnSDxMaL | Bella | Femmina americana |
ErXwobaYiN019PkySvjV | Antoni | Maschio americano |
MF3mGyEYCl7XYWbV9V6O | Elli | Americana femmina |
TxGEqnHWrfWFTfGW9XjX | Josh | Maschio americano |
VR6AewLTigWG4xSOukaG | Arnold | Maschio americano |
pNInz6obpgDQGcFmaJgB | Adamo | Maschio americano |
Node.js SDK
| Comando | Descrizione |
|---|
npm install elevenlabs | Installare Node.js SDK |
const { ElevenLabsAPI } = require('elevenlabs') | Importa SDK |
const client = new ElevenLabsAPI({ apiKey: 'key' }) | Inizializza client |
client.textToSpeech.generate() | Genera speech |
Streaming Audio
| Comando | Descrizione |
|---|
POST /v1/text-to-speech/{voice_id}/stream | Trasmetti audio |
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3 | Stream verso file |
Funzionalità Voice Lab
| Funzionalità | Descrizione |
|---|
Voice Design | Creare voci sintetiche |
Voice Cloning | Clonare voci esistenti |
Professional Cloning | Clonazione vocale di alta qualità |
Voice Library | Sfoglia raccolta vocale |
Limiti di Utilizzo API
| Piano | Caratteri/Mese | Richieste Concorrenti |
|---|
Free | 10.000 | 2 |
Starter | 30.000 | 3 |
Creator | 100.000 | 5 |
Pro | 500.000 | 10 |
Scale | 2.000.000 | 25 |
Gestione degli Errori
| Codice di Errore | Descrizione |
|---|
400 | Richiesta Non Valida |
401 | Non autorizzato |
403 | Vietato |
404 | Non trovato |
422 | Unprocessable Entity |
429 | Troppe Richieste |
500 | Errore Interno del Server |
Parametri Avanzati
| Parametro | Descrizione |
|---|
model_id | Modello TTS da utilizzare |
voice_settings | Configurazione vocale |
pronunciation_dictionary_locators | Pronunce personalizzate |
seed | Generazione riproducibile |
Configurazione Webhook
| Comando | Descrizione |
|---|
POST /v1/webhooks | Crea webhook |
GET /v1/webhooks | Elenca webhook |
DELETE /v1/webhooks/{webhook_id} | Elimina webhook |
PUT /v1/webhooks/{webhook_id} | Aggiorna webhook |
Progetti e Doppiaggio
| Comando | Descrizione |
|---|
POST /v1/projects | Crea progetto |
GET /v1/projects | Elenca progetti |
POST /v1/dubbing | Crea progetto di doppiaggio |
GET /v1/dubbing/{dubbing_id} | Ottieni stato doppiaggio |
Analytics di Utilizzo
| Comando | Descrizione |
|---|
GET /v1/user/subscription | Ottieni informazioni sull’abbonamento |
GET /v1/user | Ottieni informazioni utente |
GET /v1/usage/character-stats | Ottieni statistiche di utilizzo |
Strumento CLI
| Comando | Descrizione |
|---|
elevenlabs --help | Mostra aiuto |
elevenlabs tts --text "Hello" --voice Rachel | Genera speech |
elevenlabs voices list | Elenco voci |
elevenlabs voices clone --name "MyVoice" | Clonare voce |
| Codice | Descrizione |
|---|
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1") | Generazione di base |
play(audio) | Riproduci audio |
save(audio, "hello.mp3") | Salva su file |
| Codice | Descrizione |
|---|
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" }) | Genera audio |
fs.writeFileSync("audio.mp3", audio) | Salva su file |
| Passo | Descrizione |
|---|
1. Upload samples | Fornire campioni vocali |
2. Train model | AI impara i modelli vocali |
3. Test generation | Verificare la qualità vocale |
4. Fine-tune settings | Regola i parametri |
5. Deploy voice | Utilizzare in produzione |
| Pratica | Descrizione |
|---|
Clear audio samples | Registrazioni di alta qualità |
Diverse samples | Varie emozioni/stili |
Consistent speaker | Stessa persona durante tutto il tempo |
Proper length | 1-5 minuti totali |
Good microphone | Registrazione professionale |
| Piattaforma | Integrazione |
|---|
Discord Bot | Generazione messaggio vocale |
Podcast | Narrazione automatizzata |
E-learning | Doppiaggi del corso |
Gaming | Voci dei personaggi |
Accessibility | Sintesi vocale per persone con disabilità visive |
| Problema | Soluzione |
|---|
Poor voice quality | Migliora la qualità del campione |
Rate limit exceeded | Aggiorna il piano o aspetta |
Authentication failed | Controlla chiave API |
Voice not found | Verifica ID voce |
Audio distortion | Regola impostazioni voce |
| Variabile | Descrizione |
|---|
ELEVEN_API_KEY | Chiave di autenticazione API |
ELEVEN_API_URL | URL base dell’API |
ELEVEN_TIMEOUT | Timeout della richiesta |
| File | Descrizione |
|---|
.elevenlabs.json | File di configurazione |
voices.json | Definizioni vocali |
settings.json | Impostazioni predefinite |
| Metrica | Descrizione |
| --------- | ------------- |
Characters used | Utilizzo mensile |
API calls | Conteggio richieste |
Voice generations | Audio creato |
Error rate | Richieste fallite |