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
Installs
3
Repository
zju-real/easel
GitHub Stars
4.0K
First Seen
Sep 2, 2026