sag 是做什么的?
使用 sag 通过 ElevenLabs 进行文本转语音(TTS)并在本地播放。
API 密钥(必需)
ELEVENLABS_API_KEY(首选)SAG_API_KEY也可被 CLI 支持- 密钥文件可通过
--api-key-file、ELEVENLABS_API_KEY_FILE或SAG_API_KEY_FILE指定
快速开始
sag "Hello there"sag speak -v "Roger" "Hello"sag voicessag prompting(模型特定提示)
模型说明
- 默认:
eleven_v3(富有表现力) - 稳定:
eleven_multilingual_v2 - 快速:
eleven_flash_v2_5
发音与表达规则
- 首要修正:重拼(例如“key-note”)、添加连字符、调整大小写。
- 数字/单位/URL:
--normalize auto(如果对名称有负面影响则使用off)。 - 语言偏好:
--lang en|de|fr|...用于指导规范化。 - v3:不支持 SSML
<break>;请使用[pause]、[short pause]、[long pause]。 - v2/v2.5:支持 SSML
<break time="1.5s" />;<phoneme>未在sag中暴露。
v3 音频标签(放在行首)
[whispers]、[shouts]、[sings][laughs]、[starts laughing]、[sighs]、[exhales][sarcastic]、[curious]、[excited]、[crying]、[mischievously]- 示例:
sag "[whispers] keep this quiet. [short pause] ok?"
默认语音
ELEVENLABS_VOICE_ID或SAG_VOICE_ID
在生成长文本前,请先确认语音和朗读者。
聊天语音回复
当用户要求“语音”回复时(例如“疯狂科学家嗓音”、“用语音解释”),生成音频并发送:
# 生成音频文件
sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here"
# 然后在回复中包含:
# MEDIA:/tmp/voice-reply.mp3
语音角色提示:
- 疯狂科学家:使用
[excited]标签、戏剧性的停顿[short pause],变化强度 - 镇静:使用
[whispers]或较慢的语速 - 戏剧化:适度使用
[sings]或[shouts]
Clawd 的默认语音 ID:lj2rcrvANS3gaWWnczSX(或直接使用 -v Clawd)