URL base y autenticación
Nuestra API sigue el estándar de Chat Completions de OpenAI. Para interactuar con el servicio, debes dirigir tu cliente a https://api.grokapikey.com/v1 e incluir tu clave de API única en el encabezado Authorization. Puedes generar esta clave inmediatamente después de registrarte con solo un correo y contraseña. La clave se muestra una vez al crearla, así que guárdala de forma segura. Si la pierdes, puedes generar una nueva clave desde tu panel, lo que revoca instantáneamente la anterior. No es necesario vincular una tarjeta de crédito para la cuenta de prueba.
Tu primera petición
Comienza enviando un prompt de texto simple para verificar la conectividad. Usa el endpoint estándar chat/completions con el identificador del modelo uncensored. El siguiente ejemplo muestra un comando curl básico para probar la conexión. Esto confirma que tu autenticación es correcta y que el servicio responde. Luego puedes adaptar esta estructura para la lógica específica de tu aplicación.
Reemplaza YOUR_API_KEY con tu clave real antes de ejecutar este comando.
curl https://api.grokapikey.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."}]
}'Integración con SDK de Python
Si estás construyendo una aplicación en Python, usa la biblioteca oficial openai. Configura el cliente para usar nuestra URL base y tu clave de API. Esto te permite aprovechar los idiomatismos familiares de Python mientras accedes al modelo sin censura. El cliente maneja la serialización y el streaming automáticamente. Asegúrate de que tu entorno tenga instalada la versión más reciente de la biblioteca para la mejor compatibilidad con nuestros endpoints.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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)Integración con SDK de Node.js
Para proyectos en JavaScript o TypeScript, el SDK de OpenAI para Node.js funciona de forma nativa. Establece las propiedades apiKey y baseURL en tu objeto de configuración. Esto asegura que todas las peticiones subsiguientes se enruten a través de nuestra infraestructura. Puedes usar patrones estándar de async/await para manejar las respuestas. Este enfoque es ideal para aplicaciones del lado del servidor o funciones de borde que requieren acceso directo a la API sin hacer proxy a través de OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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);Respuestas en streaming
Para aplicaciones que se benefician de la generación de tokens en tiempo real, habilita el streaming estableciendo stream: true en el cuerpo de tu petición. La API devuelve un flujo de Server-Sent Events (SSE) con respuestas parciales. Esto reduce la latencia percibida para los usuarios y permite la visualización inmediata del texto generado. Cada fragmento contiene un delta de la respuesta. Maneja estos eventos en tu código cliente para actualizar la interfaz de usuario de forma progresiva. El streaming consume tokens normalmente y no afecta los precios.
stream = 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, errores y contexto
Cada clave de API está limitada a 300 peticiones por minuto y un tamaño máximo del cuerpo de la petición de 8 MB. Si excedes el límite de peticiones, la API devuelve un código de estado 429; espera unos segundos y reintenta. Un error 401 indica una clave inválida o revocada, mientras que un error 402 significa que tu crédito prepago se ha agotado. El modelo admite una ventana de contexto de 100.000 tokens para la entrada y la salida combinadas. Asegúrate de que tus prompts se ajusten a este límite para evitar truncamiento. Los filtros de contenido son mínimos, excepto por un bloqueo estricto de contenido sexual que involucre menores.
