O que ElevenLabs TTS faz?
Use esta habilidade para geração de texto para fala da ElevenLabs. Mantenha a habilidade reutilizável e não pessoal:
- Não armazene chaves de API, nomes de voz, IDs de voz, e-mails, nomes de contas, nomes de clientes ou padrões pessoais na habilidade.
- Leia
ELEVENLABS_API_KEYdo ambiente do processo ou do.envmais próximo. - Leia perfis de voz específicos da conta a partir de configuração JSON local fora desta habilidade.
- Gere áudio com configurações no nível da solicitação. Não altere as configurações salvas da conta ElevenLabs ou de voz, a menos que o usuário solicite explicitamente.
Perfis Locais
Prefira uma destas fontes de configuração, nesta ordem:
--config /caminho/para/perfis.jsonELEVENLABS_TTS_CONFIG=/caminho/para/perfis.jsonlocal/elevenlabs/perfis.json
Arquivos de perfil locais do projeto também são aceitáveis quando estão em .gitignore, por exemplo config/local/elevenlabs-tts.json.
O script auxiliar espera esta estrutura:
{
"default_profile": "padrao",
"profiles": {
"padrao": {
"voice_name": "Nome da voz da conta local",
"voice_id": "id-de-voz-direto-opcional",
"voice_id_env": "VARIAVEL_DE_AMBIENTE_OPCIONAL_COM_ID_DE_VOZ",
"model_id": "eleven_multilingual_v2",
"output_format": "mp3_44100_128",
"voice_settings": {
"stability": 0.5,
"similarity_boost": 1.0,
"style": 0.0,
"speed": 1.0,
"use_speaker_boost": true
},
"output_dir": "saidas/locucoes",
"emails": []
}
}
}
Campos como emails, proprietários, aliases e notas são apenas para roteamento/contexto local. O script ignora campos de metadados desconhecidos.
Fluxo de Trabalho
- Escolha o perfil a partir de
--profile,ELEVENLABS_TTS_PROFILEoudefault_profile. - Prefira o script auxiliar:
python3 <raiz-da-habilidade>/scripts/generate_voice.py --text-file script.txt --profile padrao --output output.mp3 - Se o perfil tiver
voice_id, use-o. Se tivervoice_id_env, leia essa variável de ambiente. Caso contrário, pesquise na ElevenLabs porvoice_name. - Use
model_id,output_formatevoice_settingsdo perfil, a menos que o usuário os substitua para esta geração. - Coloque o áudio gerado no destino solicitado. Se nenhum destino for fornecido, use o
output_dirdo perfil e, em seguida,outputs/voiceovers/. - Informe o caminho de saída e quaisquer avisos importantes. Não imprima segredos.
Script Auxiliar
O script incluído suporta:
--text "..."para texto inline--text-file caminho.txtpara arquivos de roteiro- stdin quando nem
--textnem--text-filesão fornecidos --profile nomepara selecionar um perfil local--config caminho.jsonpara selecionar um arquivo de perfil local--voice-id,--voice-name,--model-id,--output-formate--settings-jsonpara substituições pontuais--output caminho.mp3para escolher o arquivo de saída--dry-runpara imprimir a carga da solicitação resolvida sem chamar o endpoint de texto para fala--list-voicespara listar as vozes correspondentes da ElevenLabs sem gerar áudio
Notas da API
Use os endpoints atuais da ElevenLabs:
- Pesquisa de voz:
GET https://api.elevenlabs.io/v2/voices - Geração de fala:
POST https://api.elevenlabs.io/v1/text-to-speech/:voice_id?output_format=...
Envie a chave de API como xi-api-key.