Documentación de API

Autenticación y URL base

La URL base para todas las solicitudes es https://api.grokapiplatform.com/v1. Autentícate pasando tu clave API única en el Authorization header. Cada solicitud debe incluir este encabezado para verificar el saldo de tu cuenta y aplicar los límites de velocidad.

Endpoint de completados de chat

Envía consultas de texto a POST /v1/chat/completions. El ID del modelo a usar es "uncensored". Este extremo maneja interacciones estándar de entrada y salida de texto sin requerir configuración adicional para un uso básico.

Copycurl https://api.grokapiplatform.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check my current token usage balance."}]
  }'

El modelo opera con una ventana de contexto de 100,000 tokens. Los tokens de entrada y salida comparten este límite. Las solicitudes que excedan la ventana de contexto fallarán inmediatamente.

Respuestas en streaming con SSE

Habilita la transmisión estableciendo stream: true en tu cuerpo de solicitud. El servidor devuelve Eventos Enviados por Servidor (SSE) con actualizaciones incrementales de tokens. Úsalo para visualizaciones en tiempo real o para reducir la latencia percibida.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokapiplatform.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 detalles de uso de tokens aparecen en el último fragmento del flujo. Puedes rastrear el consumo total por solicitud sin analizar cada delta intermedio.

Llamada a funciones y herramientas

Define herramientas en el tools array y establece tool_choice para desencadenar comportamientos específicos. El modelo admite patrones estándar de uso de herramientas compatibles con los SDK de OpenAI.

Copyimport OpenAI from "openai";

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

Usar tool_choice: "auto" para selección automática o especifica un nombre de herramienta para ejecución forzada. Esto funciona sin problemas con el modelo sin censura para tareas de razonamiento complejo.

Modo JSON para salida estructurada

Establecer response_format para {"type": "json_object"} para forzar una salida JSON estricta. Esto reduce los errores de análisis al integrar con aplicaciones frontend o tuberías de datos.

Parámetros y límites

Ajustar temperature, top_p, y seed para controlar la aleatoriedad. La salida máxima por solicitud es de 16,000 tokens. Errores como 401 indican claves inválidas, 402 significa crédito prepagado insuficiente y 429 señala límites de velocidad. El límite es de 300 solicitudes por minuto por clave. El crédito nunca expira, por lo que puedes recargar con USDT o USDC cuando sea necesario.

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)