tts-voiceover
Installation
SKILL.md
文字转语音配音(TTS Voiceover)
配置检查路径铁律:先
cd到运行时说明给出的 Easel 项目根,确认当前目录有.env和skills/shared/scripts/。云 TTS 配置只能用项目根的skills/shared/scripts/model_registry.py configured --group voice --env-file .env和skills/shared/scripts/voice_clone.py check ... --env-file .env判断;不得在 workspace 跑共享脚本副本,也不得用env/printenv推断 Key/URL 缺失。
把文案 / 脚本合成为 AI 语音(口播、旁白、朗读)。共享脚本 skills/shared/scripts/tts.py speak:
默认闭源优先——配了 .env 的 VOICE_PROVIDER(+ VOICE_API_KEY) 就走闭源云 TTS(voice_clone,
按句合成+拼接+分句 SRT,有情感、像真人),没 key 才退 edge(AI 味、生硬,仅兜底)。
--engine closed/edge 可强制;闭源音色用 --voice 传 voice-id(如 FunAudioLLM/CosyVoice2-0.5B:alex),
旁白默认 alex,可用 VOICE_NARRATOR_VOICE_ID 覆盖。合成后语音可交 audio_ops.py/video_ops.py 混音或加到视频。
输入
| 字段 | 必填 | 说明 |
|---|---|---|
| text / file | 是 | 待配音的文本,或文本文件路径(长文本推荐 --file) |
| voice | 否 | 音色,默认 zh-CN-XiaoxiaoNeural(晓晓) |
| rate/volume/pitch | 否 | 语速 / 音量 / 音调微调 |
| output | 否 | 默认 outputs/主题名/{name}.mp3 |