README.md

metadata

title: Genie-TTS OpenAI Compatible API
emoji: 🔮
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
license: mit

🔮 Genie-TTS OpenAI Compatible API

基于 Genie-TTS 的 OpenAI 兼容 TTS API 服务。

🚀 功能特点

• ✅ OpenAI API 兼容 - 使用 /v1/audio/speech 端点，兼容 OpenAI SDK
• ✅ 高质量语音合成 - 基于 GPT-SoVITS V2ProPlus 模型
• ✅ 中文支持 - 目前支持中文语音合成
• ✅ WAV 输出 - 32kHz 高质量音频输出

📖 API 使用方法

端点

POST /v1/audio/speech

请求格式

{
    "model": "liang",
    "input": "你好，这是一段测试文本。"
}

请求参数

参数	类型	必需	说明
model	string	✅	语音模型名称
input	string	✅	要合成的文本
voice	string	❌	忽略 - 仅用于 OpenAI 兼容性
response_format	string	❌	忽略 - 只支持 wav
speed	number	❌	忽略 - 仅用于 OpenAI 兼容性

响应

• Content-Type: audio/wav
• 返回 WAV 格式的音频二进制数据

💻 使用示例

使用 curl

curl -X POST "https://your-space.hf.space/v1/audio/speech" \
  -H "Content-Type: application/json" \
  -d '{"model": "liang", "input": "你好，欢迎使用语音合成服务。"}' \
  --output speech.wav

使用 Python requests

import requests

response = requests.post(
    "https://your-space.hf.space/v1/audio/speech",
    json={
        "model": "liang",
        "input": "你好，这是一段测试文本。"
    }
)

with open("speech.wav", "wb") as f:
    f.write(response.content)

使用 OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="not-needed",  # API key 不需要
    base_url="https://your-space.hf.space/v1"
)

response = client.audio.speech.create(
    model="liang",
    input="你好，这是一段测试文本。",
    voice="alloy"  # 会被忽略
)

response.stream_to_file("speech.wav")

🔧 其他端点

健康检查

GET /health

响应:

{
    "status": "healthy",
    "models_loaded": 1,
    "available_models": ["liang"]
}

列出可用模型

GET /v1/models

响应:

{
    "object": "list",
    "data": [
        {
            "id": "liang",
            "object": "model",
            "created": 1234567890,
            "owned_by": "genie-tts"
        }
    ]
}

📝 可用模型

模型名称	语言	说明
liang	中文	GPT-SoVITS V2ProPlus 模型

⚠️ 注意事项

1. 首次加载可能需要一些时间
2. 免费版 CPU 推理可能较慢
3. 音频输出固定为 WAV 格式 (32kHz, 16-bit, 单声道)

🔗 相关链接

• Genie-TTS GitHub
• GPT-SoVITS

📄 许可证

MIT License