sag

O que sag faz?

Use sag para TTS da ElevenLabs com reprodução local.

Chave da API (obrigatória)

• ELEVENLABS_API_KEY (preferida)
• SAG_API_KEY também suportada pela CLI
• Arquivo de chave via --api-key-file, ELEVENLABS_API_KEY_FILE ou SAG_API_KEY_FILE

Início rápido

• sag "Olá"
• sag speak -v "Roger" "Olá"
• sag voices
• sag prompting (dicas específicas do modelo)

Notas sobre os modelos

• Padrão: eleven_v3 (expressivo)
• Estável: eleven_multilingual_v2
• Rápido: eleven_flash_v2_5

Regras de pronúncia e entrega

• Primeira correção: reformular (ex.: "key-note"), adicionar hífens, ajustar maiúsculas.
• Números/unidades/URLs: --normalize auto (ou off se prejudicar nomes).
• Viés de idioma: --lang en|de|fr|... para guiar a normalização.
• v3: SSML <break> não suportado; usar [pause], [short pause], [long pause].
• v2/v2.5: SSML <break time="1.5s" /> suportado; <phoneme> não exposto no sag.

Tags de áudio v3 (colocar no início de uma linha)

• [whispers], [shouts], [sings]
• [laughs], [starts laughing], [sighs], [exhales]
• [sarcastic], [curious], [excited], [crying], [mischievously]
• Exemplo: sag "[whispers] mantenha isso em segredo. [short pause] ok?"

Padrões de voz

• ELEVENLABS_VOICE_ID ou SAG_VOICE_ID

Confirme voz e locutor antes de uma saída longa.

Respostas de voz em chat

Quando o usuário pedir uma resposta "em voz" (ex.: "voz de cientista maluco", "explique em voz"), gere áudio e envie:

# Gerar arquivo de áudio
sag -v Clawd -o /tmp/voice-reply.mp3 "Sua mensagem aqui"

# Em seguida, incluir na resposta:
# MEDIA:/tmp/voice-reply.mp3

Dicas para personagens de voz:

• Cientista maluco: Use tags [excited], pausas dramáticas [short pause], varie a intensidade.
• Calmo: Use [whispers] ou ritmo mais lento.
• Dramático: Use [sings] ou [shouts] com moderação.

Voz padrão para Clawd: lj2rcrvANS3gaWWnczSX (ou apenas -v Clawd)