Inicio rápido para usuarios de Unhinged Grok

Autenticación y URL base

Nuestra API es compatible con OpenAI, lo que significa que no necesitas una nueva biblioteca. Solo necesitas actualizar dos valores en tu configuración existente: la base_url y la api_key. Tu clave de API se genera inmediatamente al registrarte con Google o correo electrónico. Mantén esta clave segura; es la única credencial necesaria para la autenticación.

Reemplaza la URL base estándar de OpenAI con nuestro endpoint. Este cambio dirige todas las peticiones subsiguientes a los servidores de nuestro modelo sin censura. No se requieren otros cambios de código para la generación de texto básica.

Ejemplo de configuración

• URL base: https://api.unhingedgrok.com/v1
• Clave de API: Tu clave única del panel de control

Verifica tu conexión listando los modelos disponibles. Esto confirma que tu autenticación funciona correctamente antes de enviar peticiones de generación.

Primera petición

Comienza enviando una petición simple de finalización de texto. Este ejemplo usa curl para demostrar la estructura HTTP cruda. La petición apunta al endpoint /v1/chat/completions con el ID de modelo uncensored. La respuesta devuelve el texto generado en la matriz choices.

Este enfoque directo funciona para cualquier lenguaje o herramienta que soporte formatos HTTP estándar de OpenAI. Puedes probarlo inmediatamente después de generar tu clave.

Petición HTTP directa

Copiarcurl https://api.unhingedgrok.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

Usa la biblioteca oficial de Python de OpenAI para integrar nuestra API. Instala el paquete vía pip. Inicializa el cliente con tu clave y la URL base personalizada. El resto de los métodos del SDK, como chat.completions.create, funcionan exactamente como se documenta para OpenAI.

Este método es ideal para servicios backend, scripts de procesamiento de datos o flujos de trabajo automatizados. El SDK maneja la serialización JSON y el análisis de respuestas automáticamente.

Ejemplo de código Python

Copiarfrom openai import OpenAI

client = OpenAI(base_url="https://api.unhingedgrok.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 entornos JavaScript o TypeScript, usa el paquete npm oficial openai. Configura el cliente con la misma URL base y clave. El SDK de Node admite patrones basados en callbacks y promesas.

Esta configuración te permite incrustar la generación de texto sin censura directamente en aplicaciones web, funciones serverless o herramientas de automatización basadas en Node. El manejo de errores permanece consistente con el comportamiento estándar del SDK de OpenAI.

Ejemplo de código Node.js

Copiarimport OpenAI from "openai";

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

Habilita la generación de tokens en tiempo real estableciendo stream: true. La API devuelve un flujo de Server-Sent Events (SSE). Cada fragmento contiene una respuesta parcial. El último fragmento incluye estadísticas de uso de tokens.

El streaming reduce la latencia percibida para los usuarios finales. Es esencial para interfaces de chat y aplicaciones interactivas. Maneja cada fragmento incrementalmente para actualizar la interfaz de usuario inmediatamente.

Ejemplo de código de streaming

Copiarstream = 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

Comprende las limitaciones operativas para evitar interrupciones del servicio. La ventana de contexto admite 100,000 tokens en total y, si max_tokens no está establecido, la respuesta puede extenderse hasta el final de la ventana.

Los límites de peticiones permiten 300 peticiones por minuto por clave. Las peticiones simultáneas están limitadas a 8. Los cuerpos de petición no deben exceder 8 MB. Maneja códigos de error HTTP estándar: 401 indica una clave inválida, 402 señala crédito insuficiente y 429 denota límite de peticiones alcanzado. Los errores no consumen crédito.