Comandos abrangentes de síntese de voz por IA do ElevenLabs para conversão de texto em fala e geração de voz.
Autenticação da API
| Comando | Descrição |
|---|
curl -H "xi-api-key: <api-key>" <endpoint> | Autenticação de API |
export ELEVEN_API_KEY=<key> | Definir variável de ambiente |
elevenlabs auth login | Fazer login na conta |
elevenlabs auth logout | Sair da conta |
elevenlabs auth status | Verificar status de autenticação |
API de Texto para Fala
| Endpoint | Descrição |
|---|
POST /v1/text-to-speech/{voice_id} | Gerar fala |
POST /v1/text-to-speech/{voice_id}/stream | Fluxo de fala |
GET /v1/voices | Listar vozes disponíveis |
GET /v1/voices/{voice_id} | Obter detalhes de voz |
POST /v1/voices/add | Adicionar voz personalizada |
Gerenciamento de Vozes
| Comando | Descrição |
|---|
GET /v1/voices | Listar todas as vozes |
GET /v1/voices/{voice_id} | Obter informações de voz |
DELETE /v1/voices/{voice_id} | Excluir voz personalizada |
POST /v1/voices/{voice_id}/edit | Editar configurações de voz |
GET /v1/voices/settings | Obter configurações de voz |
Geração de Fala
| Comando | Descrição |
|---|
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"}' | Geração básica de fala |
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM/stream" -H "xi-api-key: <key>" | Transmissão de fala |
SDK Python
| Comando | Descrição |
|---|
pip install elevenlabs | Instalar Python SDK |
from elevenlabs import generate, play | Importar SDK |
generate(text="Hello", voice="Bella") | Gerar fala |
play(audio) | Reproduzir áudio gerado |
save(audio, "output.mp3") | Salvar arquivo de áudio |
Clonagem de Voz
| Comando | Descrição |
|---|
POST /v1/voices/add | Clonar voz a partir de amostras |
POST /v1/voices/{voice_id}/samples | Adicionar amostras de voz |
DELETE /v1/voices/{voice_id}/samples/{sample_id} | Excluir amostra de voz |
GET /v1/voices/{voice_id}/samples | Listar amostras de voz |
Configurações de Voz
| Parâmetro | Descrição |
|---|
stability | Consistência de voz (0.0-1.0) |
similarity_boost | Similaridade de voz (0.0-1.0) |
style | Estilo de fala (0.0-1.0) |
use_speaker_boost | Aprimorar similaridade de alto-falantes |
| Formatar | Descrição |
|---|
mp3_44100_128 | MP3 44.1kHz 128kbps |
mp3_22050_32 | MP3 22.05kHz 32kbps |
pcm_16000 | PCM 16kHz |
pcm_22050 | PCM 22,05 kHz |
pcm_24000 | PCM 24kHz |
pcm_44100 | PCM 44,1 kHz |
Vozes Pré-construídas
| Voice ID | Nome | Descrição |
|---|
21m00Tcm4TlvDq8ikWAM | Rachel | Americana feminina |
AZnzlk1XvdvUeBnXmlld | Domi | Americana feminina |
EXAVITQu4vr4xnSDxMaL | Bella | Americana feminina |
ErXwobaYiN019PkySvjV | António | Homem americano |
MF3mGyEYCl7XYWbV9V6O | Elli | Americana feminina |
TxGEqnHWrfWFTfGW9XjX | Josh | Masculino americano |
VR6AewLTigWG4xSOukaG | Arnold | Masculino americano |
pNInz6obpgDQGcFmaJgB | Adão | Homem americano |
SDK Node.js
| Comando | Descrição |
|---|
npm install elevenlabs | Instalar Node.js SDK |
const { ElevenLabsAPI } = require('elevenlabs') | Importar SDK |
const client = new ElevenLabsAPI({ apiKey: 'key' }) | Inicializar cliente |
client.textToSpeech.generate() | Gerar fala |
Streaming de Áudio
| Comando | Descrição |
|---|
POST /v1/text-to-speech/{voice_id}/stream | Transmitir áudio |
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3 | Transmitir para arquivo |
Recursos do Voice Lab
| Recurso | Descrição |
|---|
Voice Design | Criar vozes sintéticas |
Voice Cloning | Clonar vozes existentes |
Professional Cloning | Clonagem de voz de alta qualidade |
Voice Library | Navegar na coleção de vozes |
Limites de Taxa da API
| Plano | Caracteres/Mês | Solicitações Concorrentes |
|---|
Free | 10.000 | 2 |
Starter | 30.000 | 3 |
Creator | 100.000 | 5 |
Pro | 500.000 | 10 |
Scale | 2.000.000 | 25 |
Tratamento de Erros
| Código de Erro | Descrição |
|---|
400 | Solicitação Inválida |
401 | Não Autorizado |
403 | Proibido |
404 | Não Encontrado |
422 | Entidade Não Processável |
429 | Muitos Pedidos |
500 | Erro Interno do Servidor |
Parâmetros Avançados
| Parâmetro | Descrição |
|---|
model_id | Modelo TTS a ser usado |
voice_settings | Configuração de voz |
pronunciation_dictionary_locators | Pronúncias personalizadas |
seed | Geração Reproduzível |
Configuração de Webhook
| Comando | Descrição |
|---|
POST /v1/webhooks | Criar webhook |
GET /v1/webhooks | Listar webhooks |
DELETE /v1/webhooks/{webhook_id} | Excluir webhook |
PUT /v1/webhooks/{webhook_id} | Atualizar webhook |
Projetos e Dublagem
| Comando | Descrição |
|---|
POST /v1/projects | Criar projeto |
GET /v1/projects | Listar projetos |
POST /v1/dubbing | Criar projeto de dublagem |
GET /v1/dubbing/{dubbing_id} | Obter status de dublagem |
Análise de Uso
| Comando | Descrição |
|---|
GET /v1/user/subscription | Obter informações de assinatura |
GET /v1/user | Obter informações do usuário |
GET /v1/usage/character-stats | Obter estatísticas de uso |
Ferramenta CLI
| Comando | Descrição |
|---|
elevenlabs --help | Mostrar ajuda |
elevenlabs tts --text "Hello" --voice Rachel | Gerar fala |
elevenlabs voices list | Listar vozes |
elevenlabs voices clone --name "MyVoice" | Clonar voz |
| Código | Descrição |
|---|
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1") | Geração básica |
play(audio) | Reproduzir áudio |
save(audio, "hello.mp3") | Salvar para arquivo |
| Código | Descrição |
|---|
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" }) | Gerar áudio |
fs.writeFileSync("audio.mp3", audio) | Salvar para arquivo |
| Passo | Descrição |
|---|
1. Upload samples | Fornecer amostras de voz |
2. Train model | IA aprende padrões de voz |
3. Test generation | Verificar qualidade de voz |
4. Fine-tune settings | Ajustar parâmetros |
5. Deploy voice | Usar em produção |
| Praticar | Descrição |
|---|
Clear audio samples | Gravações de alta qualidade |
Diverse samples | Várias emoções/estilos |
Consistent speaker | Mesma pessoa ao longo de todo o texto |
Proper length | 1-5 minutos no total |
Good microphone | Gravação profissional |
| Plataforma | Integração |
|---|
Discord Bot | Geração de mensagem de voz |
Podcast | Narração automatizada |
E-learning | Locução de curso |
Gaming | Vozes de personagens |
Accessibility | Texto para voz para pessoas com deficiência visual |
| Problema | Solução |
|---|
Poor voice quality | Melhorar qualidade da amostra |
Rate limit exceeded | Atualizar plano ou esperar |
Authentication failed | Verificar chave API |
Voice not found | Verificar ID de voz |
Audio distortion | Ajustar configurações de voz |
| Variável | Descrição |
|---|
ELEVEN_API_KEY | Chave de autenticação de API |
ELEVEN_API_URL | URL base da API |
ELEVEN_TIMEOUT | Tempo limite de solicitação |
| Arquivo | Descrição |
|---|
.elevenlabs.json | Arquivo de configuração |
voices.json | Definições de voz |
settings.json | Configurações padrão |
| Métrica | Descrição |
| --------- | ------------- |
Characters used | Uso mensal |
API calls | Contagem de solicitações |
Voice generations | Áudio criado |
Error rate | Solicitações com Falha |