| """ |
| # WebAPI文档 |
| |
| ` python api_v2.py -a 127.0.0.1 -p 9880 -c GPT_SoVITS/configs/tts_infer.yaml ` |
| |
| ## 执行参数: |
| `-a` - `绑定地址, 默认"127.0.0.1"` |
| `-p` - `绑定端口, 默认9880` |
| `-c` - `TTS配置文件路径, 默认"GPT_SoVITS/configs/tts_infer.yaml"` |
| |
| ## 调用: |
| |
| ### 推理 |
| |
| endpoint: `/tts` |
| GET: |
| ``` |
| http://127.0.0.1:9880/tts?text=先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。&text_lang=zh&ref_audio_path=archive_jingyuan_1.wav&prompt_lang=zh&prompt_text=我是「罗浮」云骑将军景元。不必拘谨,「将军」只是一时的身份,你称呼我景元便可&text_split_method=cut5&batch_size=1&media_type=wav&streaming_mode=true |
| ``` |
| |
| POST: |
| ```json |
| { |
| "text": "", # str.(required) text to be synthesized |
| "text_lang: "", # str.(required) language of the text to be synthesized |
| "ref_audio_path": "", # str.(required) reference audio path |
| "aux_ref_audio_paths": [], # list.(optional) auxiliary reference audio paths for multi-speaker tone fusion |
| "prompt_text": "", # str.(optional) prompt text for the reference audio |
| "prompt_lang": "", # str.(required) language of the prompt text for the reference audio |
| "top_k": 15, # int. top k sampling |
| "top_p": 1, # float. top p sampling |
| "temperature": 1, # float. temperature for sampling |
| "text_split_method": "cut5", # str. text split method, see text_segmentation_method.py for details. |
| "batch_size": 1, # int. batch size for inference |
| "batch_threshold": 0.75, # float. threshold for batch splitting. |
| "split_bucket": True, # bool. whether to split the batch into multiple buckets. |
| "speed_factor":1.0, # float. control the speed of the synthesized audio. |
| "fragment_interval":0.3, # float. to control the interval of the audio fragment. |
| "seed": -1, # int. random seed for reproducibility. |
| "parallel_infer": True, # bool. whether to use parallel inference. |
| "repetition_penalty": 1.35, # float. repetition penalty for T2S model. |
| "sample_steps": 32, # int. number of sampling steps for VITS model V3. |
| "super_sampling": False, # bool. whether to use super-sampling for audio when using VITS model V3. |
| "streaming_mode": False, # bool or int. return audio chunk by chunk.T he available options are: 0,1,2,3 or True/False (0/False: Disabled | 1/True: Best Quality, Slowest response speed (old version streaming_mode) | 2: Medium Quality, Slow response speed | 3: Lower Quality, Faster response speed ) |
| "overlap_length": 2, # int. overlap length of semantic tokens for streaming mode. |
| "min_chunk_length": 16, # int. The minimum chunk length of semantic tokens for streaming mode. (affects audio chunk size) |
| } |
| ``` |
| |
| RESP: |
| 成功: 直接返回 wav 音频流, http code 200 |
| 失败: 返回包含错误信息的 json, http code 400 |
| |
| ### 命令控制 |
| |
| endpoint: `/control` |
| |
| command: |
| "restart": 重新运行 |
| "exit": 结束运行 |
| |
| GET: |
| ``` |
| http://127.0.0.1:9880/control?command=restart |
| ``` |
| POST: |
| ```json |
| { |
| "command": "restart" |
| } |
| ``` |
| |
| RESP: 无 |
| |
| |
| ### 切换GPT模型 |
| |
| endpoint: `/set_gpt_weights` |
| |
| GET: |
| ``` |
| http://127.0.0.1:9880/set_gpt_weights?weights_path=GPT_SoVITS/pretrained_models/s1bert25hz-2kh-longer-epoch=68e-step=50232.ckpt |
| ``` |
| RESP: |
| 成功: 返回"success", http code 200 |
| 失败: 返回包含错误信息的 json, http code 400 |
| |
| |
| ### 切换Sovits模型 |
| |
| endpoint: `/set_sovits_weights` |
| |
| GET: |
| ``` |
| http://127.0.0.1:9880/set_sovits_weights?weights_path=GPT_SoVITS/pretrained_models/s2G488k.pth |
| ``` |
| |
| RESP: |
| 成功: 返回"success", http code 200 |
| 失败: 返回包含错误信息的 json, http code 400 |
| |
| """ |
|
|
| import os |
| import sys |
| import traceback |
| from typing import Generator, Union |
|
|
| now_dir = os.getcwd() |
| sys.path.append(now_dir) |
| sys.path.append("%s/GPT_SoVITS" % (now_dir)) |
|
|
| import argparse |
| import subprocess |
| import wave |
| import signal |
| import numpy as np |
| import soundfile as sf |
| from fastapi import FastAPI, Response |
| from fastapi.responses import StreamingResponse, JSONResponse |
| import uvicorn |
| from io import BytesIO |
| from tools.i18n.i18n import I18nAuto |
| from GPT_SoVITS.TTS_infer_pack.TTS import TTS, TTS_Config |
| from GPT_SoVITS.TTS_infer_pack.text_segmentation_method import get_method_names as get_cut_method_names |
| from pydantic import BaseModel |
| import threading |
|
|
| |
| i18n = I18nAuto() |
| cut_method_names = get_cut_method_names() |
|
|
| parser = argparse.ArgumentParser(description="GPT-SoVITS api") |
| parser.add_argument("-c", "--tts_config", type=str, default="GPT_SoVITS/configs/tts_infer.yaml", help="tts_infer路径") |
| parser.add_argument("-a", "--bind_addr", type=str, default="127.0.0.1", help="default: 127.0.0.1") |
| parser.add_argument("-p", "--port", type=int, default="9880", help="default: 9880") |
| args = parser.parse_args() |
| config_path = args.tts_config |
| |
| port = args.port |
| host = args.bind_addr |
| argv = sys.argv |
|
|
| if config_path in [None, ""]: |
| config_path = "GPT-SoVITS/configs/tts_infer.yaml" |
|
|
| tts_config = TTS_Config(config_path) |
| print(tts_config) |
| tts_pipeline = TTS(tts_config) |
|
|
| APP = FastAPI() |
|
|
|
|
| class TTS_Request(BaseModel): |
| text: str = None |
| text_lang: str = None |
| ref_audio_path: str = None |
| aux_ref_audio_paths: list = None |
| prompt_lang: str = None |
| prompt_text: str = "" |
| top_k: int = 15 |
| top_p: float = 1 |
| temperature: float = 1 |
| text_split_method: str = "cut5" |
| batch_size: int = 1 |
| batch_threshold: float = 0.75 |
| split_bucket: bool = True |
| speed_factor: float = 1.0 |
| fragment_interval: float = 0.3 |
| seed: int = -1 |
| media_type: str = "wav" |
| streaming_mode: Union[bool, int] = False |
| parallel_infer: bool = True |
| repetition_penalty: float = 1.35 |
| sample_steps: int = 32 |
| super_sampling: bool = False |
| overlap_length: int = 2 |
| min_chunk_length: int = 16 |
|
|
|
|
| def pack_ogg(io_buffer: BytesIO, data: np.ndarray, rate: int): |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
|
|
| def handle_pack_ogg(): |
| with sf.SoundFile(io_buffer, mode="w", samplerate=rate, channels=1, format="ogg") as audio_file: |
| audio_file.write(data) |
|
|
|
|
|
|
| |
| |
| |
| |
| |
| stack_size = 4096 * 4096 |
| try: |
| threading.stack_size(stack_size) |
| pack_ogg_thread = threading.Thread(target=handle_pack_ogg) |
| pack_ogg_thread.start() |
| pack_ogg_thread.join() |
| except RuntimeError as e: |
| |
| print("RuntimeError: {}".format(e)) |
| print("Changing the thread stack size is unsupported.") |
| except ValueError as e: |
| |
| print("ValueError: {}".format(e)) |
| print("The specified stack size is invalid.") |
|
|
| return io_buffer |
|
|
|
|
| def pack_raw(io_buffer: BytesIO, data: np.ndarray, rate: int): |
| io_buffer.write(data.tobytes()) |
| return io_buffer |
|
|
|
|
| def pack_wav(io_buffer: BytesIO, data: np.ndarray, rate: int): |
| io_buffer = BytesIO() |
| sf.write(io_buffer, data, rate, format="wav") |
| return io_buffer |
|
|
|
|
| def pack_aac(io_buffer: BytesIO, data: np.ndarray, rate: int): |
| process = subprocess.Popen( |
| [ |
| "ffmpeg", |
| "-f", |
| "s16le", |
| "-ar", |
| str(rate), |
| "-ac", |
| "1", |
| "-i", |
| "pipe:0", |
| "-c:a", |
| "aac", |
| "-b:a", |
| "192k", |
| "-vn", |
| "-f", |
| "adts", |
| "pipe:1", |
| ], |
| stdin=subprocess.PIPE, |
| stdout=subprocess.PIPE, |
| stderr=subprocess.PIPE, |
| ) |
| out, _ = process.communicate(input=data.tobytes()) |
| io_buffer.write(out) |
| return io_buffer |
|
|
|
|
| def pack_audio(io_buffer: BytesIO, data: np.ndarray, rate: int, media_type: str): |
| if media_type == "ogg": |
| io_buffer = pack_ogg(io_buffer, data, rate) |
| elif media_type == "aac": |
| io_buffer = pack_aac(io_buffer, data, rate) |
| elif media_type == "wav": |
| io_buffer = pack_wav(io_buffer, data, rate) |
| else: |
| io_buffer = pack_raw(io_buffer, data, rate) |
| io_buffer.seek(0) |
| return io_buffer |
|
|
|
|
| |
| def wave_header_chunk(frame_input=b"", channels=1, sample_width=2, sample_rate=32000): |
| |
| |
| |
| wav_buf = BytesIO() |
| with wave.open(wav_buf, "wb") as vfout: |
| vfout.setnchannels(channels) |
| vfout.setsampwidth(sample_width) |
| vfout.setframerate(sample_rate) |
| vfout.writeframes(frame_input) |
|
|
| wav_buf.seek(0) |
| return wav_buf.read() |
|
|
|
|
| def handle_control(command: str): |
| if command == "restart": |
| os.execl(sys.executable, sys.executable, *argv) |
| elif command == "exit": |
| os.kill(os.getpid(), signal.SIGTERM) |
| exit(0) |
|
|
|
|
| def check_params(req: dict): |
| text: str = req.get("text", "") |
| text_lang: str = req.get("text_lang", "") |
| ref_audio_path: str = req.get("ref_audio_path", "") |
| streaming_mode: bool = req.get("streaming_mode", False) |
| media_type: str = req.get("media_type", "wav") |
| prompt_lang: str = req.get("prompt_lang", "") |
| text_split_method: str = req.get("text_split_method", "cut5") |
|
|
| if ref_audio_path in [None, ""]: |
| return JSONResponse(status_code=400, content={"message": "ref_audio_path is required"}) |
| if text in [None, ""]: |
| return JSONResponse(status_code=400, content={"message": "text is required"}) |
| if text_lang in [None, ""]: |
| return JSONResponse(status_code=400, content={"message": "text_lang is required"}) |
| elif text_lang.lower() not in tts_config.languages: |
| return JSONResponse( |
| status_code=400, |
| content={"message": f"text_lang: {text_lang} is not supported in version {tts_config.version}"}, |
| ) |
| if prompt_lang in [None, ""]: |
| return JSONResponse(status_code=400, content={"message": "prompt_lang is required"}) |
| elif prompt_lang.lower() not in tts_config.languages: |
| return JSONResponse( |
| status_code=400, |
| content={"message": f"prompt_lang: {prompt_lang} is not supported in version {tts_config.version}"}, |
| ) |
| if media_type not in ["wav", "raw", "ogg", "aac"]: |
| return JSONResponse(status_code=400, content={"message": f"media_type: {media_type} is not supported"}) |
| |
| |
|
|
| if text_split_method not in cut_method_names: |
| return JSONResponse( |
| status_code=400, content={"message": f"text_split_method:{text_split_method} is not supported"} |
| ) |
|
|
| return None |
|
|
|
|
| async def tts_handle(req: dict): |
| """ |
| Text to speech handler. |
| |
| Args: |
| req (dict): |
| { |
| "text": "", # str.(required) text to be synthesized |
| "text_lang: "", # str.(required) language of the text to be synthesized |
| "ref_audio_path": "", # str.(required) reference audio path |
| "aux_ref_audio_paths": [], # list.(optional) auxiliary reference audio paths for multi-speaker tone fusion |
| "prompt_text": "", # str.(optional) prompt text for the reference audio |
| "prompt_lang": "", # str.(required) language of the prompt text for the reference audio |
| "top_k": 15, # int. top k sampling |
| "top_p": 1, # float. top p sampling |
| "temperature": 1, # float. temperature for sampling |
| "text_split_method": "cut5", # str. text split method, see text_segmentation_method.py for details. |
| "batch_size": 1, # int. batch size for inference |
| "batch_threshold": 0.75, # float. threshold for batch splitting. |
| "split_bucket": True, # bool. whether to split the batch into multiple buckets. |
| "speed_factor":1.0, # float. control the speed of the synthesized audio. |
| "fragment_interval":0.3, # float. to control the interval of the audio fragment. |
| "seed": -1, # int. random seed for reproducibility. |
| "parallel_infer": True, # bool. whether to use parallel inference. |
| "repetition_penalty": 1.35, # float. repetition penalty for T2S model. |
| "sample_steps": 32, # int. number of sampling steps for VITS model V3. |
| "super_sampling": False, # bool. whether to use super-sampling for audio when using VITS model V3. |
| "streaming_mode": False, # bool or int. return audio chunk by chunk.T he available options are: 0,1,2,3 or True/False (0/False: Disabled | 1/True: Best Quality, Slowest response speed (old version streaming_mode) | 2: Medium Quality, Slow response speed | 3: Lower Quality, Faster response speed ) |
| "overlap_length": 2, # int. overlap length of semantic tokens for streaming mode. |
| "min_chunk_length": 16, # int. The minimum chunk length of semantic tokens for streaming mode. (affects audio chunk size) |
| } |
| returns: |
| StreamingResponse: audio stream response. |
| """ |
|
|
| streaming_mode = req.get("streaming_mode", False) |
| return_fragment = req.get("return_fragment", False) |
| media_type = req.get("media_type", "wav") |
|
|
| check_res = check_params(req) |
| if check_res is not None: |
| return check_res |
| |
| if streaming_mode == 0: |
| streaming_mode = False |
| return_fragment = False |
| fixed_length_chunk = False |
| elif streaming_mode == 1: |
| streaming_mode = False |
| return_fragment = True |
| fixed_length_chunk = False |
| elif streaming_mode == 2: |
| streaming_mode = True |
| return_fragment = False |
| fixed_length_chunk = False |
| elif streaming_mode == 3: |
| streaming_mode = True |
| return_fragment = False |
| fixed_length_chunk = True |
|
|
| else: |
| return JSONResponse(status_code=400, content={"message": f"the value of streaming_mode must be 0, 1, 2, 3(int) or true/false(bool)"}) |
|
|
| req["streaming_mode"] = streaming_mode |
| req["return_fragment"] = return_fragment |
| req["fixed_length_chunk"] = fixed_length_chunk |
|
|
| print(f"{streaming_mode} {return_fragment} {fixed_length_chunk}") |
|
|
| streaming_mode = streaming_mode or return_fragment |
|
|
|
|
| try: |
| tts_generator = tts_pipeline.run(req) |
|
|
| if streaming_mode: |
|
|
| def streaming_generator(tts_generator: Generator, media_type: str): |
| if_frist_chunk = True |
| for sr, chunk in tts_generator: |
| if if_frist_chunk and media_type == "wav": |
| yield wave_header_chunk(sample_rate=sr) |
| media_type = "raw" |
| if_frist_chunk = False |
| yield pack_audio(BytesIO(), chunk, sr, media_type).getvalue() |
|
|
| |
| return StreamingResponse( |
| streaming_generator( |
| tts_generator, |
| media_type, |
| ), |
| media_type=f"audio/{media_type}", |
| ) |
|
|
| else: |
| sr, audio_data = next(tts_generator) |
| audio_data = pack_audio(BytesIO(), audio_data, sr, media_type).getvalue() |
| return Response(audio_data, media_type=f"audio/{media_type}") |
| except Exception as e: |
| return JSONResponse(status_code=400, content={"message": "tts failed", "Exception": str(e)}) |
|
|
|
|
| @APP.get("/control") |
| async def control(command: str = None): |
| if command is None: |
| return JSONResponse(status_code=400, content={"message": "command is required"}) |
| handle_control(command) |
|
|
|
|
| @APP.get("/tts") |
| async def tts_get_endpoint( |
| text: str = None, |
| text_lang: str = None, |
| ref_audio_path: str = None, |
| aux_ref_audio_paths: list = None, |
| prompt_lang: str = None, |
| prompt_text: str = "", |
| top_k: int = 15, |
| top_p: float = 1, |
| temperature: float = 1, |
| text_split_method: str = "cut5", |
| batch_size: int = 1, |
| batch_threshold: float = 0.75, |
| split_bucket: bool = True, |
| speed_factor: float = 1.0, |
| fragment_interval: float = 0.3, |
| seed: int = -1, |
| media_type: str = "wav", |
| parallel_infer: bool = True, |
| repetition_penalty: float = 1.35, |
| sample_steps: int = 32, |
| super_sampling: bool = False, |
| streaming_mode: Union[bool, int] = False, |
| overlap_length: int = 2, |
| min_chunk_length: int = 16, |
| ): |
| req = { |
| "text": text, |
| "text_lang": text_lang.lower(), |
| "ref_audio_path": ref_audio_path, |
| "aux_ref_audio_paths": aux_ref_audio_paths, |
| "prompt_text": prompt_text, |
| "prompt_lang": prompt_lang.lower(), |
| "top_k": top_k, |
| "top_p": top_p, |
| "temperature": temperature, |
| "text_split_method": text_split_method, |
| "batch_size": int(batch_size), |
| "batch_threshold": float(batch_threshold), |
| "speed_factor": float(speed_factor), |
| "split_bucket": split_bucket, |
| "fragment_interval": fragment_interval, |
| "seed": seed, |
| "media_type": media_type, |
| "streaming_mode": streaming_mode, |
| "parallel_infer": parallel_infer, |
| "repetition_penalty": float(repetition_penalty), |
| "sample_steps": int(sample_steps), |
| "super_sampling": super_sampling, |
| "overlap_length": int(overlap_length), |
| "min_chunk_length": int(min_chunk_length), |
| } |
| return await tts_handle(req) |
|
|
|
|
| @APP.post("/tts") |
| async def tts_post_endpoint(request: TTS_Request): |
| req = request.dict() |
| return await tts_handle(req) |
|
|
|
|
| @APP.get("/set_refer_audio") |
| async def set_refer_aduio(refer_audio_path: str = None): |
| try: |
| tts_pipeline.set_ref_audio(refer_audio_path) |
| except Exception as e: |
| return JSONResponse(status_code=400, content={"message": "set refer audio failed", "Exception": str(e)}) |
| return JSONResponse(status_code=200, content={"message": "success"}) |
|
|
|
|
| |
| |
| |
| |
| |
| |
|
|
| |
| |
| |
| |
| |
|
|
| |
| |
| |
| |
|
|
|
|
| @APP.get("/set_gpt_weights") |
| async def set_gpt_weights(weights_path: str = None): |
| try: |
| if weights_path in ["", None]: |
| return JSONResponse(status_code=400, content={"message": "gpt weight path is required"}) |
| tts_pipeline.init_t2s_weights(weights_path) |
| except Exception as e: |
| return JSONResponse(status_code=400, content={"message": "change gpt weight failed", "Exception": str(e)}) |
|
|
| return JSONResponse(status_code=200, content={"message": "success"}) |
|
|
|
|
| @APP.get("/set_sovits_weights") |
| async def set_sovits_weights(weights_path: str = None): |
| try: |
| if weights_path in ["", None]: |
| return JSONResponse(status_code=400, content={"message": "sovits weight path is required"}) |
| tts_pipeline.init_vits_weights(weights_path) |
| except Exception as e: |
| return JSONResponse(status_code=400, content={"message": "change sovits weight failed", "Exception": str(e)}) |
| return JSONResponse(status_code=200, content={"message": "success"}) |
|
|
|
|
| if __name__ == "__main__": |
| try: |
| if host == "None": |
| host = None |
| uvicorn.run(app=APP, host=host, port=port, workers=1) |
| except Exception: |
| traceback.print_exc() |
| os.kill(os.getpid(), signal.SIGTERM) |
| exit(0) |
|
|