用途:sag 用于调用 ElevenLabs 文本转语音并本地播放或导出音频文件,交互风格类似 mac 的 say 命令。
必要配置:需要 API key,优先使用 ELEVENLABS_API_KEY,CLI 亦支持 SAG_API_KEY。音色默认可通过 ELEVENLABS_VOICE_ID 或 SAG_VOICE_ID 设置。
基本用法:
- 直接朗读:sag "Hello there"
- 指定音色:sag speak -v "Roger" "Hello"
- 列出音色:sag voices
- 输出音频文件:sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here"
- 查看提示技巧:sag 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" />,但 sag 未暴露 <phoneme>。
v3 音频标签(置于行首):[whispers]、[shouts]、[sings]、[laughs]、[starts laughing]、[sighs]、[exhales]、[sarcastic]、[curious]、[excited]、[crying]、[mischievously]。示例:sag "[whispers] keep this quiet. [short pause] ok?"
提示:长文本输出前应先确认音色与说话人。资料未提供价格、平台支持范围及安装方式等信息。