GPT-SoVITS/docs/simple_api_quickstart.md

简化 TTS 接口快速启动

完整教程见：docs/simple_api.md

一句话流程

启动后端，打开测试页，上传 3-10 秒参考音频或视频（视频会自动提取音频），填写生成文字，点击生成。

1. 启动后端

cd D:\tts\GPT-SoVITS
python -m pip install -r requirements.txt
.\go-simple-api.ps1

也可以运行：

go-simple-api.bat

默认后端地址：

http://127.0.0.1:9881

2. 打开测试前端

后端启动后访问：

http://127.0.0.1:9881/test/

测试页面里的默认接口地址是：

http://127.0.0.1:9881/api/tts

3. 调用接口

接口：

POST /api/tts
Content-Type: multipart/form-data

最小字段：

text       要生成的文字
ref_audio  3-10 秒主参考音频（支持视频，前端自动提取音频）

常用可选字段：

aux_ref_audio  辅助参考音频，可多个
prompt_text    参考音频文本，可留空
text_lang      默认 zh
prompt_lang    默认 zh
emotion        neutral / happy / calm / sad / angry
speed          语速，默认 1
seed           默认 -1

4. PowerShell 示例

curl.exe -X POST http://127.0.0.1:9881/api/tts `
  -F "text=你好，欢迎使用这个声音。" `
  -F "ref_audio=@D:\audio\ref.wav" `
  -F "prompt_text=" `
  -F "text_lang=zh" `
  -F "prompt_lang=zh" `
  --output output.wav

5. 注意事项

• 主参考音频必须是 3-10 秒。
• prompt_text 在当前 v2 配置下可以为空。
• 如果切换到 v3/v4，空 prompt_text 会返回 400。
• 生成文字固定按标点符号切句。
• 更详细的配置、profile、base64 接口见 docs/simple_api.md。