Pular para o conteúdo

Comandos do ElevenLabs

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

ComandoDescriçã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 loginFazer login na conta
elevenlabs auth logoutSair da conta
elevenlabs auth statusVerificar status de autenticação

API de Texto para Fala

EndpointDescrição
POST /v1/text-to-speech/{voice_id}Gerar fala
POST /v1/text-to-speech/{voice_id}/streamFluxo de fala
GET /v1/voicesListar vozes disponíveis
GET /v1/voices/{voice_id}Obter detalhes de voz
POST /v1/voices/addAdicionar voz personalizada

Gerenciamento de Vozes

ComandoDescrição
GET /v1/voicesListar 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}/editEditar configurações de voz
GET /v1/voices/settingsObter configurações de voz

Geração de Fala

ComandoDescriçã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

ComandoDescrição
pip install elevenlabsInstalar Python SDK
from elevenlabs import generate, playImportar SDK
generate(text="Hello", voice="Bella")Gerar fala
play(audio)Reproduzir áudio gerado
save(audio, "output.mp3")Salvar arquivo de áudio

Clonagem de Voz

ComandoDescrição
POST /v1/voices/addClonar voz a partir de amostras
POST /v1/voices/{voice_id}/samplesAdicionar amostras de voz
DELETE /v1/voices/{voice_id}/samples/{sample_id}Excluir amostra de voz
GET /v1/voices/{voice_id}/samplesListar amostras de voz

Configurações de Voz

ParâmetroDescrição
stabilityConsistência de voz (0.0-1.0)
similarity_boostSimilaridade de voz (0.0-1.0)
styleEstilo de fala (0.0-1.0)
use_speaker_boostAprimorar similaridade de alto-falantes

Formatos de Áudio

FormatarDescrição
mp3_44100_128MP3 44.1kHz 128kbps
mp3_22050_32MP3 22.05kHz 32kbps
pcm_16000PCM 16kHz
pcm_22050PCM 22,05 kHz
pcm_24000PCM 24kHz
pcm_44100PCM 44,1 kHz

Vozes Pré-construídas

Voice IDNomeDescrição
21m00Tcm4TlvDq8ikWAMRachelAmericana feminina
AZnzlk1XvdvUeBnXmlldDomiAmericana feminina
EXAVITQu4vr4xnSDxMaLBellaAmericana feminina
ErXwobaYiN019PkySvjVAntónioHomem americano
MF3mGyEYCl7XYWbV9V6OElliAmericana feminina
TxGEqnHWrfWFTfGW9XjXJoshMasculino americano
VR6AewLTigWG4xSOukaGArnoldMasculino americano
pNInz6obpgDQGcFmaJgBAdãoHomem americano

SDK Node.js

ComandoDescrição
npm install elevenlabsInstalar 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

ComandoDescrição
POST /v1/text-to-speech/{voice_id}/streamTransmitir áudio
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3Transmitir para arquivo

Recursos do Voice Lab

RecursoDescrição
Voice DesignCriar vozes sintéticas
Voice CloningClonar vozes existentes
Professional CloningClonagem de voz de alta qualidade
Voice LibraryNavegar na coleção de vozes

Limites de Taxa da API

PlanoCaracteres/MêsSolicitações Concorrentes
Free10.0002
Starter30.0003
Creator100.0005
Pro500.00010
Scale2.000.00025

Tratamento de Erros

Código de ErroDescrição
400Solicitação Inválida
401Não Autorizado
403Proibido
404Não Encontrado
422Entidade Não Processável
429Muitos Pedidos
500Erro Interno do Servidor

Parâmetros Avançados

ParâmetroDescrição
model_idModelo TTS a ser usado
voice_settingsConfiguração de voz
pronunciation_dictionary_locatorsPronúncias personalizadas
seedGeração Reproduzível

Configuração de Webhook

ComandoDescrição
POST /v1/webhooksCriar webhook
GET /v1/webhooksListar webhooks
DELETE /v1/webhooks/{webhook_id}Excluir webhook
PUT /v1/webhooks/{webhook_id}Atualizar webhook

Projetos e Dublagem

ComandoDescrição
POST /v1/projectsCriar projeto
GET /v1/projectsListar projetos
POST /v1/dubbingCriar projeto de dublagem
GET /v1/dubbing/{dubbing_id}Obter status de dublagem

Análise de Uso

ComandoDescrição
GET /v1/user/subscriptionObter informações de assinatura
GET /v1/userObter informações do usuário
GET /v1/usage/character-statsObter estatísticas de uso

Ferramenta CLI

ComandoDescrição
elevenlabs --helpMostrar ajuda
elevenlabs tts --text "Hello" --voice RachelGerar fala
elevenlabs voices listListar vozes
elevenlabs voices clone --name "MyVoice"Clonar voz
CódigoDescriçã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ódigoDescrição
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" })Gerar áudio
fs.writeFileSync("audio.mp3", audio)Salvar para arquivo
PassoDescrição
1. Upload samplesFornecer amostras de voz
2. Train modelIA aprende padrões de voz
3. Test generationVerificar qualidade de voz
4. Fine-tune settingsAjustar parâmetros
5. Deploy voiceUsar em produção
PraticarDescrição
Clear audio samplesGravações de alta qualidade
Diverse samplesVárias emoções/estilos
Consistent speakerMesma pessoa ao longo de todo o texto
Proper length1-5 minutos no total
Good microphoneGravação profissional
PlataformaIntegração
Discord BotGeração de mensagem de voz
PodcastNarração automatizada
E-learningLocução de curso
GamingVozes de personagens
AccessibilityTexto para voz para pessoas com deficiência visual
ProblemaSolução
Poor voice qualityMelhorar qualidade da amostra
Rate limit exceededAtualizar plano ou esperar
Authentication failedVerificar chave API
Voice not foundVerificar ID de voz
Audio distortionAjustar configurações de voz
VariávelDescrição
ELEVEN_API_KEYChave de autenticação de API
ELEVEN_API_URLURL base da API
ELEVEN_TIMEOUTTempo limite de solicitação
ArquivoDescrição
.elevenlabs.jsonArquivo de configuração
voices.jsonDefinições de voz
settings.jsonConfigurações padrão
MétricaDescrição
----------------------
Characters usedUso mensal
API callsContagem de solicitações
Voice generationsÁudio criado
Error rateSolicitações com Falha