| name | audio |
| description | Gera áudio (TTS) via ElevenLabs. Use quando o usuário quiser:
- Converter texto em fala
- Gerar áudio narrado
- Enviar mensagem de voz gerada
- Criar podcast/narração
|
Audio Generation (TTS)
Gera áudio a partir de texto usando ElevenLabs Text-to-Speech.
Como usar
Gerar áudio simples
ravi audio generate "Olá, eu sou o Ravi!"
Com voz específica
ravi audio generate "Hello world" --voice JBFqnCBsd6RMkjVDRZzb
Com velocidade alterada
ravi audio generate "Texto rápido" --speed 1.5
Com idioma forçado
ravi audio generate "Bom dia a todos" --lang pt
Gerar e enviar direto no chat
ravi audio generate "Mensagem de voz" --send
Gerar a partir de arquivo de texto
ravi audio generate --text-file roteiro.md --lang fr --send
--text-file só aceita arquivos relativos ao diretório atual, sem .., e apenas extensões .md ou .txt. Use isso para textos longos em vez de $(cat ...), heredoc, python -c ou substituição de shell.
Com caption custom ao enviar
ravi audio generate "Conteúdo importante" --send --caption "Escuta isso"
Modelo turbo (mais rápido, menos expressivo)
ravi audio generate "Quick response" --model eleven_turbo_v2_5
Salvar em diretório específico
ravi audio generate "Narração" -o /tmp/audios
Opções
| Flag | Descrição | Default |
|---|
--voice <id> | Voice ID do ElevenLabs | env ELEVENLABS_VOICE_ID ou default |
--model <model> | eleven_multilingual_v2, eleven_turbo_v2_5 | eleven_multilingual_v2 |
--speed <speed> | Velocidade 0.5-2.0 | 1.0 |
--lang <code> | Idioma ISO 639-1 (pt, en, es) | auto-detect |
--format <fmt> | mp3_44100_128, mp3_22050_32, pcm_16000 | mp3_44100_128 |
-o, --output <dir> | Diretório de saída | /tmp |
--send | Envia pro chat automaticamente | false |
--caption <text> | Caption ao enviar (com --send) | início do texto |
--text-file <path> | Lê texto de arquivo relativo .md ou .txt | nenhum |
Retorno
O comando retorna o path do áudio gerado + o comando pra enviar:
✓ Audio saved: /tmp/ravi-audio-1234567890.mp3
Send to chat: ravi media send "/tmp/ravi-audio-1234567890.mp3"
Se usar --send, o Ravi entrega direto via omni send em vez de só publicar um evento interno. O retorno passa a refletir ack/erro real da entrega e preserva thread/topic quando existir no contexto.
Fluxo recomendado
- Rode
ravi audio generate "texto" — gera o MP3
- Para textos longos, salve em
.md ou .txt no diretório atual e use --text-file caminho-relativo.md
- Se precisa enviar pro chat, use
--send ou copie o comando ravi media send do output
- Pra português, use
--lang pt pra melhor pronúncia
Limitações
- Requer
ELEVENLABS_API_KEY no ~/.ravi/.env
- Textos muito longos podem demorar
- Voices customizadas precisam do voice ID específico
Configuração
ELEVENLABS_API_KEY — obrigatória, no ~/.ravi/.envELEVENLABS_VOICE_ID — voice padrão (opcional)
