Inicio rápido para pipelines Xtts

Autenticación y URL base

Empieza yendo a la página Obtener clave de API e inicia sesión con Google o una contraseña de correo electrónico. Recibirás una clave de API única de inmediato. Usa la URL base https://api.xtts.cc/v1 para todas las peticiones. Esta URL es compatible con los SDK oficiales de OpenAI y cualquier cliente que admita el formato de chat-completions de OpenAI.

Incluye tu clave en el encabezado Authorization como token bearer. El identificador de modelo que debes enviar es uncensored. Este modelo de pesos abiertos está alojado en nuestros servidores y está ajustado para responder sin rechazos de contenido para uso adulto lícito, asegurando que tu pipeline de voz reciba el texto sin filtros que necesita.

Generar texto sin censura

Envía una petición POST a /v1/chat/completions con tus prompts de sistema y usuario. La API devuelve JSON estructurado con el texto generado. Este endpoint está diseñado para la redacción de prompts, generación de guiones y tareas de postprocesamiento en tu flujo de trabajo de clonación de voz.

El cuerpo de la petición incluye el nombre del modelo, tu historial de mensajes y parámetros opcionales como temperature o top_p. Puedes controlar la longitud de la salida con el parámetro max_tokens. Si no estableces max_tokens, la respuesta puede extenderse hasta el final de la ventana de contexto.

Copiarcurl https://api.xtts.cc/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

Usa el SDK oficial de Python de OpenAI para interactuar con nuestra API. Establece el base_url a nuestro endpoint y proporciona tu clave de API. Este enfoque te permite aprovechar las estructuras de código existentes mientras te beneficias del comportamiento de nuestro modelo sin censura.

Crea una instancia de cliente con la URL base y luego llama a chat.completions.create. Pasa el ID del modelo uncensored y tus mensajes. El objeto de respuesta contiene el texto generado en content. Este método es ideal para scripts de procesamiento por lotes o para integrar la generación de texto en aplicaciones Python más grandes.

Copiarfrom openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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

Para entornos JavaScript, usa el SDK de Node de OpenAI. Configura el cliente con nuestra URL base y clave de API. Esta configuración te permite generar texto directamente en tus aplicaciones web o del lado del servidor.

Llama al endpoint de chat completions con el modelo uncensored. La respuesta proporciona el texto generado, que luego puedes pasar a tu motor de síntesis de voz. Esta integración es adecuada para la generación de texto en tiempo real en aplicaciones web o servicios de servidor que preparan guiones para clonación de voz.

Copiarimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.xtts.cc/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

Habilita el streaming estableciendo stream en true en tu petición. La API devuelve Eventos enviados por el servidor (SSE) para cada token generado. Esta función es útil para la visualización de texto en tiempo real o la preparación progresiva de síntesis de voz.

Cada fragmento de evento contiene texto parcial. El último fragmento incluye estadísticas de uso, como conteos de tokens. El streaming asegura que tu aplicación pueda procesar el texto a medida que se genera, reduciendo la latencia percibida para los usuarios. Maneja los eventos de streaming para acumular la respuesta completa.

Copiarstream = 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 de velocidad y parámetros

Cada clave de API tiene un límite de 300 peticiones por minuto y 8 peticiones simultáneas. El cuerpo de la petición no debe superar los 8 MB. Si envías una clave no válida, recibirás un error 401. Si tu crédito prepago se agota, recibirás un error 402. Exceder el límite de peticiones genera un error 429.

La ventana de contexto admite un total de 100,000 tokens, incluyendo tanto el prompt como la finalización. No hay un límite de salida separado, y puedes especificar un max_tokens menor si deseas una respuesta más corta. Los errores y rechazos no consumen tu crédito prepago. Hay soporte para llamadas a funciones y modo JSON disponibles para la extracción de datos estructurados.