使用CoquiTTS下载模型时config_path返回None报错求助

算力阿峰

2026-7-5

解决Coqui TTS中config_path返回None的问题

问题原因

手动指定.models.json路径可能导致ModelManager无法正确关联已下载的模型配置，或是模型已存在时的内部逻辑未正确返回配置文件路径。

解决方案

方案1：使用官方推荐的简化API（最稳定）

跳过手动初始化ModelManager和Synthesizer，直接用TTS类的封装方法：

from TTS.api import TTS

# 初始化模型，自动处理下载/加载
tts = TTS(model_name="tts_models/multilingual/multi-dataset/xtts_v2", gpu=False)

# 生成并保存音频
text = "I am a text read by a computer"
tts.tts_to_file(text=text, file_path="audio.wav")

方案2：修复手动初始化逻辑

如果需要保留手动流程，按以下步骤修改：

移除手动指定的.models.json路径，让ModelManager使用默认路径
若仍返回None，直接从model_item中提取配置路径：

from TTS.utils.manage import ModelManager   
from TTS.utils.synthesizer import Synthesizer

# 不传入path，使用ModelManager默认配置
model_manager = ModelManager()

model_path, config_path, model_item = model_manager.download_model("tts_models/multilingual/multi-dataset/xtts_v2")

# 手动补全配置路径（针对模型已存在时的返回异常）
if config_path is None:
    config_path = model_item["config_path"]

print(config_path)

syn = Synthesizer(
    tts_checkpoint=model_path,
    tts_config_path=config_path
)

text = "I am a text read by a computer"
outputs = syn.tts(text)
syn.save_wav(outputs, "audio.wav")