Inicio rápido: Usa la api de clave groq

Configuración de autenticación de URL Base

La API de clave groq reemplaza el punto de conexión estándar de OpenAI con un camino directo a nuestro modelo sin censura. Configura tu base_url a HTTPS://api.groqkeyapi.com/v1 e inyecta tu clave en el Authorization header. Esta configuración funciona con cualquier cliente compatible con OpenAI, incluidos los SDK oficiales de Python y Node. No necesitas modificar el nombre del modelo en tu código; nosotros gestionamos el enrutamiento internamente.

Copycurl https://api.groqkeyapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if endpoint supports 32k context window"}]
  }'

La autenticación es estricta. Un error 401 significa que tu clave es inválida o falta. Asegúrate de copiar la clave inmediatamente después del registro, ya que solo se muestra una vez.

Primera solicitud de finalización de chat

Envía una solicitud POST a /v1/chat/completions con el ID del modelo establecido en "uncensored". Este modelo responde sin rechazos para temas adultos lícitos, ficticios o controvertidos. Procesa entrada de texto y devuelve salida de texto. Puedes ajustar parámetros como temperature y top_p para controlar la creatividad. La ventana de contexto admite 100,000 tokens para la combinación de prompt y finalización.

Copyfrom openai import OpenAI

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

Los errores durante el procesamiento no consumen crédito. Si el modelo devuelve un rechazo por contenido menor, no pagas nada. Este modelo prepagado asegura que solo gastes en tokens de salida reales.

Activa la transmisión para salida en tiempo real

El streaming mediante Server-Sent Events (SSE) entrega tokens a medida que se generan. Configura stream=true en tu solicitud. El último fragmento contiene las estadísticas completas de uso de tokens para la facturación. Este enfoque reduce la latencia percibida para respuestas largas. Es ideal para interfaces de chat donde los usuarios ven el texto aparecer en tiempo real. Los SDK manejan el análisis automáticamente.

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)

El streaming no cambia la estructura de precios. Sigues pagando por 1M de tokens de salida. El límite estricto de 16,000 tokens por solicitud sigue aplicándose independientemente del estado del streaming.

Usa el modo JSON para datos estructurados

Establecer response_format para {"type": "json_object"} para forzar una salida JSON estricta. Esto es útil para integraciones programáticas donde necesitas estructuras de datos predecibles. El modelo intentará formatear la respuesta como JSON válido. Puede fallar si el prompt es demasiado complejo o la salida excede los límites. Valida siempre el JSON en el lado del cliente.

Copyimport OpenAI from "openai";

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

También se admite la llamada a funciones. Puedes definir herramientas y permitir que el modelo elija cuáles invocar. Esto amplía las capacidades de la API más allá de la simple generación de texto.

Límites de solicitud y manejo de errores

La API limita a 300 solicitudes por minuto por clave. Puedes ejecutar 8 solicitudes concurrentes simultáneamente. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Un error 429 indica que has superado estos límites. Espera unos segundos y reintenta. Un error 402 significa que tu crédito prepagado se ha agotado. Recarga mediante criptomonedas para reanudar el servicio. Errores como 400 o 500 no cobran créditos.

El id del modelo es siempre "uncensored". No intentes cambiar de modelos. Alojamos un único modelo de lenguaje grande optimizado para contenido sin restricciones. Esto mantiene la pila simple y rápida.

Ventana de contexto y límites de tokens

Tu ventana de contexto total es de 100.000 tokens. Esto incluye tanto la solicitud de entrada como la completación generada. La salida máxima por solicitud es de 16.000 tokens. Si no especificas max_tokens, el valor predeterminado es 2,048 tokens. Exceder el límite de salida truncará la respuesta. Planifica tus prompts para dejar suficiente espacio para la respuesta completa. Esto permite una retención profunda del contexto sin fragmentación manual.

Streaming y el modo JSON no afectan estos límites. Se mantienen constantes en todos los tipos de solicitud. Usa el usage field in the response to track your consumption accurately.