Guia rápido da API TTS

URL base e autenticação

Comece configurando seu cliente para apontar para nosso base URL: https://api.ttsapihub.com/v1. Nossa API é totalmente compatível com OpenAI, então você pode usar SDKs padrão apenas atualizando o base_url e fornecendo sua chave de API. A autenticação é feita por meio do cabeçalho Authorization com um token Bearer. Você gera uma chave exclusiva durante o cadastro na página Obter chave de API. Cada conta tem limite de uma chave ativa, que pode ser regenerada a qualquer momento. Seus prompts não são usados para treinamento, e nenhum número de telefone ou cartão de crédito é necessário para começar com o crédito de teste grátis.

Gerar texto com Chat Completions

Envie uma requisição POST /v1/chat/completions padrão para gerar texto. O ID do modelo a ser usado é uncensored. Este modelo é um LLM de pesos abertos ajustado para responder sem recusas de conteúdo para uso adulto legal, tornando-o ideal para roteiros criativos ou diálogos onde filtros corporativos podem bloquear seu conteúdo. Ele não gera áudio, imagens ou vídeo; ele produz texto puro para seu pipeline TTS processar. Você pode ajustar parâmetros como temperature e max_tokens conforme necessário. A API suporta chamada de funções para extração de dados estruturados, permitindo que você formate as respostas para seu aplicativo.

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integração com SDK Python

Para desenvolvedores Python, o SDK oficial openai funciona imediatamente com configuração mínima. Inicialize o cliente com sua URL base e chave de API, depois chame chat.completions.create(). Esta abordagem permite aproveitar clientes compatíveis com OpenAI existentes enquanto se beneficia do nosso modelo sem censura. A resposta inclui o texto gerado, que você pode alimentar diretamente no seu mecanismo de síntese de fala. Lembre-se de que esta é uma API apenas de texto, então você cuida da geração de áudio separadamente no seu pipeline.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ttsapihub.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Integração com SDK Node.js

Desenvolvedores Node.js podem usar o pacote npm openai com a mesma configuração do Python. Defina o baseURL para nosso endpoint e forneça sua chave de API. Chame o endpoint de conclusões com o ID do modelo uncensored. Esta integração é direta e permite integrar nossa geração de texto diretamente em seus serviços TTS existentes da Node.js. A API responde com JSON padrão, facilitando a análise e o processamento do texto gerado para as necessidades do seu aplicativo.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ttsapihub.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Respostas em streaming via SSE

Para menor latência, ative o streaming definindo stream: true em sua requisição. A API retorna Server-Sent Events (SSE) contendo pedaços incrementais de texto. Isso é particularmente útil para geração de conteúdo extenso, pois os usuários podem ver o texto aparecendo em tempo real. A resposta de streaming segue o formato padrão SSE da OpenAI, então você pode usar analisadores de stream existentes. Esta abordagem reduz os tempos de espera percebidos e permite que seu aplicativo exiba o texto conforme é gerado, melhorando a experiência do usuário para seu pipeline TTS.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Limites, erros e janela de contexto

Sua chave de API está limitada a 300 requisições por minuto e um corpo de requisição de 8 MB. O modelo suporta uma janela de contexto de 100.000 tokens, permitindo roteiros ou documentos longos. Erros comuns incluem 401 (chave inválida), 402 (crédito insuficiente) e 429 (limite de requisições). Se você atingir o limite de requisições, implemente backoff exponencial. Os preços são transparentes: $0,25 por 1M tokens de entrada e $1,00 por 1M tokens de saída. Os créditos são pré-pagos, nunca expiram e recargas começam em $10. Uma nova conta recebe $0,50 em crédito de teste válido por 7 dias, sem necessidade de cartão. Limites de conteúdo bloqueiam apenas conteúdo sexual envolvendo menores; todos os outros tópicos adultos legais, fictícios ou controversos são permitidos.