Inicio rápido para pipelines de Whisper

Prerrequisitos

Antes de comenzar, asegúrate de tener una cuenta activa y una clave de API. Regístrate en la página Obtener clave de API usando solo tu correo electrónico y una contraseña. La clave aparece de inmediato. Recibes $0.50 en crédito de prueba válido por 7 días, sin necesidad de tarjeta de crédito. Para producción, recarga desde $10 mediante criptomonedas (USDT o USDC). Nuestra tarifa es clara: $0.25 por cada 1M de tokens de entrada y $1.00 por cada 1M de tokens de salida. Los créditos no caducan.

URL base: https://api.whisperapis.com/v1. Este endpoint es compatible con cualquier cliente compatible con OpenAI. Solo necesitas configurar la URL base y proporcionar tu clave de API en el encabezado de autorización. No se requieren SDK especiales para peticiones HTTP básicas.

Inicializar cliente

La mayoría de los desarrolladores usarán el SDK oficial de OpenAI o una biblioteca compatible. Inicializa el cliente apuntándolo a nuestra URL base. Esto asegura que todas las peticiones se enruten hacia nuestro modelo sin censura en lugar de los servidores de OpenAI. El ID del modelo es siempre uncensored.

Asegúrate de que tu variable de entorno OPENAI_API_KEY esté configurada con tu clave del panel. Si usas un lenguaje o biblioteca diferente, verifica que admita URLs base personalizadas. El SDK se encarga de la serialización JSON y la inyección de encabezados por ti, reduciendo el código repetitivo en tus scripts de pipeline.

Enviar completación de chat

Envía una petición estándar de completación de chat para refinar la salida de tu pipeline. Por ejemplo, extrae JSON estructurado de transcripciones de voz a texto o genera subtítulos para imágenes sin filtros de contenido.

El endpoint es POST /v1/chat/completions. Incluye el ID del modelo, tu matriz de mensajes y opcionalmente tu prompt de sistema para definir el comportamiento sin censura.

Copycurl https://api.whisperapis.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."}]
  }'

Nuestro modelo maneja bien los datos de alto contexto, admitiendo hasta 100.000 tokens en total. Esto es ideal para procesar transcripciones largas o descripciones detalladas de imágenes en un solo paso.

Respuestas en streaming

Para el postprocesamiento en tiempo real o pipelines interactivos, activa el streaming. Establece el parámetro stream en true en tu petición. La API devuelve Eventos Enviados por Servidor (SSE) en lugar de un único objeto JSON.

Analiza los campos delta a medida que llegan. Esto reduce la latencia percibida para salidas grandes, como generar scripts detallados o extraer bloques de texto largos de resultados de OCR ruidosos. El formato de streaming es compatible con los controladores de streaming estándar del SDK de OpenAI.

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)

Asegúrate de que tu cliente gestione correctamente los fragmentos parciales. Agrega los deltas para reconstruir la respuesta de texto completa una vez que el flujo termine con un finish_reason de stop o length.

Soporte para llamadas a funciones

Nuestro modelo sin censura admite llamadas a funciones, lo que te permite definir salidas estructuradas para tus pipelines. Define tus herramientas en la matriz tools con definiciones de esquema JSON.

El modelo devuelve llamadas a funciones en la respuesta, que puedes ejecutar para actualizar el contexto de la conversación. Esto es útil para extraer puntos de datos específicos de texto no estructurado, como fechas, nombres o coordenadas de transcripciones de voz.

Copyfrom openai import OpenAI

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

Pasa las llamadas a funciones de nuevo a la API en mensajes posteriores. El modelo refinará su salida basándose en los resultados. Esto permite razonamiento complejo en varios pasos sin salir de la interfaz de chat. Asegúrate de que tu esquema sea estricto para evitar respuestas JSON mal formadas.

Límites, errores y contexto

Monitorea tu uso para evitar interrupciones. La API aplica un límite de 300 peticiones por minuto por clave. Si excedes este límite, recibirás un error de límite de peticiones 429. Implementa retroceso exponencial en tu cliente.

Errores comunes:

• 401: Clave de API inválida o expirada. Regenera tu clave desde el panel.
• 402: Crédito insuficiente. Recarga tu cuenta para continuar procesando.
• 429: Límite de peticiones excedido. Reduce la frecuencia de peticiones o agrupa tareas más pequeñas.

Ventana de contexto: El modelo admite 100.000 tokens para prompt + finalización. Si tu entrada supera este límite, trunca los mensajes antiguos o divide los datos. Los cuerpos de las peticiones están limitados a 8 MB. Asegúrate de que tus cargas útiles se ajusten a estas restricciones para un rendimiento fiable.

Node.js

Copyimport OpenAI from "openai";

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