mirror of
https://github.com/RVC-Boss/GPT-SoVITS.git
synced 2026-07-04 04:58:12 +08:00
735b2e3554
- Add simple_api.py: profile-based API that wraps GPT-SoVITS TTS engine - Add /api/tts endpoint for MVP: accepts ref audio/video, text, optional aux audio - Frontend auto-extracts audio from uploaded video files via Web Audio API - Add emotion presets (neutral/happy/calm/sad/angry) with speed customization - Add test_frontend/index.html with health check, audio playback, and download - Add contract tests (7 tests, all passing) using mock TTS pipeline - Add documentation: simple_api.md (full tutorial), simple_api_quickstart.md - Add startup scripts: go-simple-api.ps1, go-simple-api.bat, open-test-frontend.ps1 - Add soundfile and python-multipart to requirements.txt - Text splitting fixed to cut5 (punctuation-based) per MVP spec
90 lines
1.7 KiB
Markdown
90 lines
1.7 KiB
Markdown
# 简化 TTS 接口快速启动
|
||
|
||
完整教程见：`docs/simple_api.md`
|
||
|
||
## 一句话流程
|
||
|
||
启动后端，打开测试页，上传 3-10 秒参考音频或视频（视频会自动提取音频），填写生成文字，点击生成。
|
||
|
||
## 1. 启动后端
|
||
|
||
```powershell
|
||
cd D:\tts\GPT-SoVITS
|
||
python -m pip install -r requirements.txt
|
||
.\go-simple-api.ps1
|
||
```
|
||
|
||
也可以运行：
|
||
|
||
```bat
|
||
go-simple-api.bat
|
||
```
|
||
|
||
默认后端地址：
|
||
|
||
```text
|
||
http://127.0.0.1:9881
|
||
```
|
||
|
||
## 2. 打开测试前端
|
||
|
||
后端启动后访问：
|
||
|
||
```text
|
||
http://127.0.0.1:9881/test/
|
||
```
|
||
|
||
测试页面里的默认接口地址是：
|
||
|
||
```text
|
||
http://127.0.0.1:9881/api/tts
|
||
```
|
||
|
||
## 3. 调用接口
|
||
|
||
接口：
|
||
|
||
```http
|
||
POST /api/tts
|
||
Content-Type: multipart/form-data
|
||
```
|
||
|
||
最小字段：
|
||
|
||
```text
|
||
text 要生成的文字
|
||
ref_audio 3-10 秒主参考音频（支持视频，前端自动提取音频）
|
||
```
|
||
|
||
常用可选字段：
|
||
|
||
```text
|
||
aux_ref_audio 辅助参考音频，可多个
|
||
prompt_text 参考音频文本，可留空
|
||
text_lang 默认 zh
|
||
prompt_lang 默认 zh
|
||
emotion neutral / happy / calm / sad / angry
|
||
speed 语速，默认 1
|
||
seed 默认 -1
|
||
```
|
||
|
||
## 4. PowerShell 示例
|
||
|
||
```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`。
|