Documentación de la API

Autenticación y URL base

Empieza por generar tu clave a través del panel de control. Usa la URL base https://api.grokapipricing.com/v1 para todas las solicitudes. Configura el Authorization header para Bearer YOUR_API_KEY. Una sola clave funciona en todos los puntos finales. Rotarla libremente si es necesario.

POST /v1/chat/completions

Envía tus prompts al endpoint de chat. El ID del modelo es siempre uncensored. Configura parámetros como temperature o top_p para controlar la creatividad. Las respuestas devuelven finalizaciones de chat estándar con metadatos de uso de tokens. Errores como 402 o 429 indican problemas de facturación o límites de tasa.

GET /v1/models

Verificar los modelos disponibles enviando una solicitud GET al endpoint de modelos. Verás el uncensored modelo listado. Esto confirma la conectividad y la disponibilidad del modelo. Usa esto para depurar configuraciones de cliente antes de enviar cargas pesadas.

Streaming y uso SSE

Habilita la transmisión estableciendo stream: true en tu cuerpo de solicitud. La API devuelve Eventos Enviados por Servidor (SSE) para la entrega de tokens en tiempo real. Las estadísticas de uso de tokens aparecen en el último fragmento del flujo. Esto reduce la latencia percibida para respuestas largas.

Llamada de Función y Modo JSON

Usar response_format con {"type": "json_object"} para salidas JSON estrictas. Habilita la llamada de funciones definiendo tools en tu solicitud. El modelo admite tool_choice para ejecución forzada o automática. Esto garantiza una integración fiable con la lógica de tu backend.

Límites de velocidad y restricciones

Estás limitado a 300 solicitudes por minuto por clave. La concurrencia está limitada a 8 solicitudes simultáneas. El tamaño máximo del cuerpo de la solicitud es de 8 MB. La ventana de contexto permite un total de 100.000 tokens. Las solicitudes que excedan estos límites recibirán errores 429 o 400 inmediatamente.

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Transmisión

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)