Skip to content
OneTTS Gateway · Síntese de Voz de Alto Desempenho

Nova Geração UnificadaGateway TTS Auto-Hospedado

Agregue Edge-TTS, Kokoro, CosyVoice e OpenAI em um gateway de síntese de voz ultrarrápido e 100% compatível com a API da OpenAI.

# 1. Pull and run OneTTS Gateway Service
$ docker run -d -p 8030:8030 --name onetts codeandxv/onetts:latest
INFO: Registering TTS Engines: [edgetts, kokoro, openai]
INFO: Application startup complete. Uvicorn running on http://0.0.0.0:8030
OpenAI Speech API ready at /v1/audio/speech

Projetado para Agentes de Voz em Tempo Real

Alta concorrência, latência de streaming inferior a 200 ms e compatibilidade universal.

🎙️API Padrão

Compatível com OpenAI Speech

Substituto direto para /v1/audio/speech, /v1/models e /v1/audio/voices sem alterar o código da aplicação.

⚡< 200ms

Streaming em Partes < 200 ms

Divisão inteligente em frases e transferência HTTP Chunked para reprodução instantânea sem esperar a geração total.

🧩Multi-Motor

Agregação Multi-Motor

Interface unificada para Microsoft Edge-TTS, Kokoro-82M ONNX, CosyVoice e relay upstream da OpenAI com mais de 400 vozes.

💾Cache

Cache Inteligente de Áudio MD5

O armazenamento em disco previne sínteses duplicadas e entrega respostas em menos de 10 ms para frases recorrentes.

🛡️Privado

100% Auto-Hospedado e Privado

Implantação local com Docker ou uv. Privacidade total sem transmissão de áudio para nuvens públicas.

🎛️Controle Fino

Controle Preciso & Múltiplos Formatos

Ajuste fino de velocidade, tom e volume com suporte a formatos MP3, WAV, AAC, OPUS e FLAC.

Motores de Síntese Compatíveis

Escolha o motor ideal conforme seus requisitos de latência, hardware e qualidade vocal.

MotorTipoVozes / IdiomasLatênciaHardwareIdeal para
Edge-TTSRecomendadoNuvem / Gratuito400+ Vozes / 40+ Idiomas150 - 300msCPU / Baixa memóriaLeitura geral, textos multilíngues, produção de audiolivros
Kokoro-82MUltra RápidoONNX LocalInglês / Japonês / Chinês< 150msCPU ou GPU CUDAAgentes conversacionais em tempo real, NPCs em jogos
CosyVoiceRede Neural LocalClonagem Zero-Shot250 - 450msGPU NVIDIA (CUDA)Clonagem de voz personalizada de alta fidelidade e locução emotiva
OpenAI RelayNuvem Upstreamalloy, echo, fable, onyx, nova, shimmer300 - 600msApenas chave de APIFallback oficial da OpenAI e proxy multi-modelo

Fluxo de Processamento TTS

Da solicitação de texto ao streaming de áudio em quatro etapas otimizadas.

Step 01

Autenticação & Análise da API

Valida tokens e analisa modelo, voz, texto, velocidade e formato de áudio solicitado.

Step 02

Normalização & Verificação de Cache MD5

Compara hash com o cache em disco ou divide o texto em blocos naturais.

Step 03

Despacho para o Motor & Síntese

Encaminha as frases ao motor selecionado para síntese neural paralela.

Step 04

Codificação & Streaming Chunked

Codifica e transmite o áudio diretamente ao cliente salvando no cache.

Integração sem Mudar de SDK

Basta alterar o parâmetro base_url no SDK oficial da OpenAI para usar o OneTTS.

from openai import OpenAI

# Initialize client pointing to your local OneTTS gateway
client = OpenAI(
    base_url="http://localhost:8030/v1",
    api_key="sk-onetts-v1-k_8LxQm9Z2sTwE7rY1u"
)

# Synthesize speech stream using Edge-TTS or Kokoro
response = client.audio.speech.create(
    model="edgetts",
    voice="zh-CN-YunxiNeural",
    input="你好,这是通过 OneTTS 高性能语音合成网关生成的高保真音频流!",
    response_format="mp3",
    speed=1.0
)

# Stream or save audio directly
response.stream_to_file("output.mp3")

Released under the Apache-2.0 License.