Comandi ElevenLabs¶

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
## Formati Audio

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

Parametro	Descrizione
`model_id`	Modello TTS da utilizzare
`voice_settings`	Configurazione vocale
`pronunciation_dictionary_locators`	Pronunce personalizzate
`seed`	Generazione riproducibile
## Configurazione Webhook

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