GPT-SoVITS: 57.5K+ Stars — AI声音克隆生产部署指南 2026

# 步骤1: 创建并激活环境
conda create -n GPTSoVits python=3.10 -y
conda activate GPTSoVits

# 步骤2: 安装 FFmpeg
conda install ffmpeg -y

# 步骤3: 克隆仓库
git clone https://github.com/RVC-Boss/GPT-SoVITS.git
cd GPT-SoVITS

# 步骤4: 安装依赖
pip install -r extra-req.txt --no-deps
pip install -r requirements.txt

# 从 HuggingFace 下载整合包
# 解压后运行:
conda create -n GPTSoVits python=3.10
conda activate GPTSoVits
pwsh -F install.ps1 -Device CU126 -Source HF

# 克隆并进入项目目录
git clone https://github.com/RVC-Boss/GPT-SoVITS.git
cd GPT-SoVITS

# 构建前拉取最新代码
git pull origin main

# 构建 Docker 镜像 (CUDA 12.8, 完整版)
bash docker_build.sh --cuda 12.8

# 或使用 Docker Hub 预构建镜像
docker compose run --service-ports GPT-SoVITS-CU128

# docker-compose.override.yaml 用于生产
services:
  GPT-SoVITS-CU128:
    shm_size: '16g'
    environment:
      - is_half=true
    ports:
      - "9874:9874"
      - "9880:9880"
    volumes:
      - ./models:/workspace/models
      - ./outputs:/workspace/outputs
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]

# 下载预训练模型 (运行一次)
mkdir -p GPT_SoVITS/pretrained_models

# 通过 install.sh 自动从 HuggingFace 下载
# 或手动下载 V4 模型:
# s2v4.pth, vocoder.pth → GPT_SoVITS/pretrained_models/gsv-v4-pretrained/

# 下载 G2PW 模型用于中文 TTS
# 解压 G2PWModel.zip 并放入: GPT_SoVITS/text/G2PWModel/

# 下载 UVR5 权重用于人声分离
# 放入: tools/uvr5/uvr5_weights/

# 标准启动 (默认端口 9874)
python webui.py

# 指定语言
python webui.py zh

# 仅启动推理 API 服务器
python api_v2.py

# 安装 ComfyUI-GPT-SoVITS 节点
cd ComfyUI/custom_nodes
git clone https://github.com/yaolidi/ComfyUI-GPT-SoVITS.git

# 安装依赖
pip install -r ComfyUI-GPT-SoVITS/requirements.txt

# 将训练好的 .pth 和 .ckpt 模型放入:
# ComfyUI/models/GPT-SoVITS/

# 流水线: GPT-SoVITS TTS → RVC 语音转换
import requests
import subprocess

# 步骤1: 使用 GPT-SoVITS API 生成语音
tts_payload = {
    "text": "你好，这是一个克隆的声音。",
    "text_lang": "zh",
    "ref_audio_path": "/path/to/reference.wav",
    "prompt_text": "参考文本转录",
    "prompt_lang": "zh",
    "media_type": "wav"
}

response = requests.post("http://localhost:9880/tts", json=tts_payload)
with open("tts_output.wav", "wb") as f:
    f.write(response.content)

# 步骤2: 通过 RVC 转换 (可选实时VC)
rvc_cmd = [
    "python", "RVC/infer_cli.py",
    "--input", "tts_output.wav",
    "--model", "models/rvc_model.pth",
    "--output", "final_output.wav"
]
subprocess.run(rvc_cmd)

from melo.api import TTS
import requests

# 步骤1: 使用 MeloTTS 预处理文本获取音素
tts_model = TTS(language="ZH", device="auto")
phonemes = tts_model.text_to_phone("你好世界")

# 步骤2: 将处理后的文本送入 GPT-SoVITS
response = requests.post("http://localhost:9880/tts", json={
    "text": phonemes,
    "text_lang": "zh",
    "ref_audio_path": "/path/to/ref.wav",
    "prompt_text": "原始提示文本",
    "prompt_lang": "zh"
})

# 启动 API 服务器
python api_v2.py -a 0.0.0.0 -p 9880

# 在 http://localhost:9880/docs 查看 API 文档

# Python 客户端示例
import requests

def synthesize(text, ref_audio, prompt_text, output_path):
    payload = {
        "text": text,
        "text_lang": "zh",
        "ref_audio_path": ref_audio,
        "prompt_text": prompt_text,
        "prompt_lang": "zh",
        "top_k": 15,
        "top_p": 1.0,
        "temperature": 1.0,
        "speed_factor": 1.0,
        "media_type": "wav"
    }
    
    response = requests.post(
        "http://localhost:9880/tts",
        json=payload,
        timeout=60
    )
    
    if response.status_code == 200:
        with open(output_path, "wb") as f:
            f.write(response.content)
        return True
    return False

# 使用
synthesize(
    "生产级语音克隆部署现在变得简单了。",
    "/voices/speaker_ref.wav",
    "这是参考转录文本。",
    "/output/cloned.wav"
)

# 使用社区 OpenAI 兼容包装器
git clone https://github.com/enihsyou/GPT-SoVITS-2-OpenAI.git
cd GPT-SoVITS-2-OpenAI
cp .env.example .env
cp config.yaml.example config.yaml

# 设置 BACKEND_URL 指向你的 GPT-SoVITS API
# BACKEND_URL=http://host.docker.internal:9880

docker compose up -d
# 现在服务在 http://localhost:5000/v1/audio/speech

# 启用半精度 (fp16) 减少50%显存占用
export is_half=true

# 6GB显存显卡使用CPU卸载文本编码器
python webui.py --device cuda --half_precision --offload_text_encoder

# 低显存配置使用CPU推理版本
git clone https://github.com/baicai-1145/GPT-SoVITS-CPUFast.git

# 导出为ONNX加速推理
python GPT_SoVITS/onnx_export.py \
    --gpt_model GPT_SoVITS/GPT_weights/your_model.ckpt \
    --sovits_model GPT_SoVITS/SoVITS_weights/your_model.pth \
    --output_dir ./onnx_models/

# TensorRT优化用于NVIDIA部署
/usr/src/tensorrt/bin/trtexec \
    --onnx=./onnx_models/gpt_model.onnx \
    --saveEngine=./trt_models/gpt_model.trt \
    --fp16

# api_v2.py 生产环境包装器，带限流
from fastapi import FastAPI, HTTPException
from fastapi.middleware.cors import CORSMiddleware
import asyncio
from collections import defaultdict
import time

app = FastAPI()
rate_limits = defaultdict(list)

@app.middleware("http")
async def rate_limit(request, call_next):
    client = request.client.host
    now = time.time()
    rate_limits[client] = [t for t in rate_limits[client] if now - t < 60]
    
    if len(rate_limits[client]) >= 10:  # 每分钟10次
        raise HTTPException(429, "请求频率超限")
    
    rate_limits[client].append(now)
    return await call_next(request)

# 为Web客户端添加CORS
app.add_middleware(
    CORSMiddleware,
    allow_origins=["https://yourdomain.com"],
    allow_methods=["POST"],
    allow_headers=["*"],
)

#!/bin/bash
# batch_synthesize.sh — 批量处理文本文件

INPUT_DIR="./texts/"
REF_AUDIO="./references/narrator.wav"
REF_TEXT="这只敏捷的棕色狐狸跳过了懒狗。"
OUTPUT_DIR="./outputs/"
mkdir -p "$OUTPUT_DIR"

for txt_file in "$INPUT_DIR"/*.txt; do
    filename=$(basename "$txt_file" .txt)
    
    curl -X POST http://localhost:9880/tts \
        -H "Content-Type: application/json" \
        -d "{
            \"text\": $(jq -Rs . < "$txt_file"),
            \"text_lang\": \"zh\",
            \"ref_audio_path\": \"$REF_AUDIO\",
            \"prompt_text\": \"$REF_TEXT\",
            \"prompt_lang\": \"zh\",
            \"media_type\": \"wav\"
        }" \
        --output "$OUTPUT_DIR/${filename}.wav"
    
    echo "已生成: $OUTPUT_DIR/${filename}.wav"
done

# nginx 反向代理配置
server {
    listen 443 ssl;
    server_name tts.yourdomain.com;
    
    ssl_certificate /etc/ssl/certs/tts.crt;
    ssl_certificate_key /etc/ssl/private/tts.key;
    
    location / {
        auth_request /auth;
        proxy_pass http://127.0.0.1:9880;
        proxy_set_header Host $host;
        client_max_body_size 50M;
    }
    
    location = /auth {
        internal;
        proxy_pass http://127.0.0.1:5000/verify;
        proxy_pass_request_body off;
    }
}