live-digital-avatar-gptsovits/README.md

# GPT_SoVITS 服务 README

## 简要说明

克隆音色并提供实时 TTS Web API，可动态切换 GPT/Sovits 权重，支持流式输出。

## 启动

```
python api_v2.py -a 0.0.0.0 -p 9880 -c GPT_SoVITS/configs/tts_infer.yaml
````

## 后台运行与日志

```
nohup python api_v2.py -a 0.0.0.0 -p 9880 -c GPT_SoVITS/configs/tts_infer.yaml  > log/gptsovits.log 2>&1 &
tail -n 50 -f log/gptsovits.log
```

## 主要接口

### 1. /tts

合成语音（GET/POST），成功返回 WAV 流，失败返回 JSON 错误。

**必需字段（POST 示例）：**

```json
{
  "text": "要合成的文本",
  "text_lang": "zh",
  "ref_audio_path": "参考音频.wav",
  "prompt_lang": "zh"
}
```

可选字段有 `prompt_text`、`aux_ref_audio_paths`、`streaming_mode`、`speed_factor` 等。

### 2. /control

控制服务。`command` 可为 `restart` 或 `exit`。

GET 示例：

```
/control?command=restart
```

POST 示例：

```json
{ "command": "restart" }
```

### 3. /set\_gpt\_weights

切换 GPT 模型权重：

```
/set_gpt_weights?weights_path=路径.ckpt
```

返回 `"success"` 或错误 JSON。

### 4. /set\_sovits\_weights

切换 Sovits 模型权重：

```
/set_sovits_weights?weights_path=路径.pth
```

返回 `"success"` 或错误 JSON。

## 示例 curl

```
curl --location --request POST 'http://192.168.10.113:9880/tts' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "先帝创业未半而中道崩殂。",
    "text_lang": "zh",
    "ref_audio_path": "input/gentle_girl.wav",
    "prompt_lang": "zh",
    "prompt_text": "刚进直播间的宝子们，左上角先点个关注，点亮咱们家的粉丝灯牌！我是你们的主播陈婉婉，今天给大家准备了超级重磅的福利",
    "media_type": "wav",
    "streaming_mode": false
}'
```