Guía rápida de la API TTS

URL base y autenticación

Comienza configurando tu cliente para que apunte a nuestra URL base: https://api.ttsapihub.com/v1. Nuestra API es totalmente compatible con OpenAI, por lo que puedes usar SDKs estándar simplemente actualizando la base_url y proporcionando tu clave de API. La autenticación se maneja mediante el encabezado Authorization con un token Bearer. Generas una clave única durante el registro en la página Obtener clave de API. Cada cuenta está limitada a una clave activa, la cual puedes regenerar en cualquier momento. Tus prompts no se utilizan para entrenamiento y no se requiere número de teléfono ni tarjeta de crédito para comenzar con el crédito de prueba.

Generar texto con finalizaciones de chat

Envía una petición POST /v1/chat/completions estándar para generar texto. El ID del modelo a usar es uncensored. Este modelo es un LLM de pesos abiertos ajustado para responder sin rechazos de contenido para uso adulto lícito, lo que lo hace ideal para guiones creativos o diálogos donde los filtros corporativos podrían bloquear tu contenido. No genera audio, imágenes ni video; produce texto puro para que tu pipeline TTS lo procese. Puedes ajustar parámetros como temperature y max_tokens según sea necesario. La API admite llamadas a funciones para la extracción de datos estructurados, lo que te permite formatear las respuestas para tu aplicación.

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."}]
  }'

Integración con SDK de Python

Para desarrolladores de Python, el SDK oficial openai funciona de inmediato con una configuración mínima. Inicializa el cliente con tu URL base y clave de API, luego llama a chat.completions.create(). Este enfoque te permite aprovechar clientes compatibles con OpenAI mientras te beneficias de nuestro modelo sin censura. La respuesta incluye el texto generado, que puedes alimentar directamente en tu motor de síntesis de voz. Recuerda que esta es una API solo de texto, por lo que gestionas la generación de audio por separado en tu 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)

Integración con SDK de Node.js

Los desarrolladores de Node.js pueden usar el paquete npm openai con la misma configuración que Python. Establece el baseURL a nuestro endpoint y proporciona tu clave de API. Llama al endpoint de finalizaciones con el ID del modelo uncensored. Esta integración es sencilla y te permite integrar nuestra generación de texto directamente en tus servicios TTS existentes de Node.js. La API responde con JSON estándar, lo que facilita analizar y procesar el texto generado para las necesidades de tu aplicación.

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);

Respuestas en streaming vía SSE

Para una menor latencia, habilita el streaming estableciendo stream: true en tu petición. La API devuelve Eventos Enviados por el Servidor (SSE) que contienen fragmentos de texto incrementales. Esto es particularmente útil para la generación de contenido extenso, ya que los usuarios pueden ver el texto aparecer en tiempo real. La respuesta en streaming sigue el formato estándar de SSE de OpenAI, por lo que puedes usar analizadores de streaming existentes. Este enfoque reduce los tiempos de espera percibidos y permite que tu aplicación muestre el texto a medida que se genera, mejorando la experiencia de usuario para tu 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)

Límites, errores y ventana de contexto

Tu clave de API está limitada a 300 peticiones por minuto y un cuerpo de petición de 8 MB. El modelo admite una ventana de contexto de 100.000 tokens, lo que permite guiones o documentos largos. Los errores comunes incluyen 401 (clave no válida), 402 (crédito insuficiente) y 429 (límite de peticiones). Si alcanzas el límite de peticiones, implementa retroceso exponencial. La tarifa es transparente: $0,25 por 1M de tokens de entrada y $1,00 por 1M de tokens de salida. Los créditos son prepago, no caducan y las recargas comienzan en $10. Una cuenta nueva recibe $0,50 en crédito de prueba válido por 7 días, sin necesidad de tarjeta. Los límites de contenido bloquean únicamente contenido sexual que involucre a menores; todos los demás temas adultos, ficticios o controvertidos de carácter lícito están permitidos.