Inicio rápido para usuarios de Grok NSFW

Autenticación y URL base

Nuestra API implementa el protocolo compatible con openai. Te autenticas pasando tu clave de API única en el encabezado Authorization. La URL base para todas las peticiones es https://api.groknsfw.cc/v1. A diferencia de los proveedores estándar, no requerimos un ID de organización específico. Simplemente genera tu clave desde el panel o la página de registro rápido. Mantén tu clave segura; otorga acceso completo a tu crédito prepago. No hay cuotas ni suscripciones mensuales, solo precios por token sin caducidad.

Toda petición debe incluir el identificador del modelo uncensored. Este modelo es un modelo de lenguaje grande de pesos abiertos alojado en nuestra infraestructura, distinto de otros proveedores. Está ajustado para ofrecer respuestas sin restricciones para contenido adulto lícito manteniendo alta fidedignidad. No necesitas cambiar la versión de tu biblioteca cliente; los SDKs estándar de OpenAI funcionan de forma inmediata.

Completado de chat básico

Envía una petición estándar de finalización de chat para generar texto. El endpoint acepta una lista de mensajes, incluidos los roles system, user y assistant. Esta estructura te permite definir contexto, instrucciones e historial de conversación. El modelo devuelve una respuesta de texto basada en el prompt proporcionado. Puedes controlar la creatividad de la salida usando parámetros como temperature y top_p. Si no se especifica max_tokens, el límite de salida predeterminado es de 2,048 tokens. Puedes aumentar esto hasta 32,000 tokens por petición, dentro de la ventana de contexto total de 100,000 tokens.

Los errores se devuelven en formato JSON estándar. Los problemas comunes incluyen claves no válidas o crédito insuficiente. La API no realiza la tokenización por ti; envías texto y el modelo lo procesa internamente. Recibes el texto generado final o streaming parcial si está habilitado.

Respuestas en streaming

Llamadas a funciones y herramientas

La API admite llamadas a funciones, lo que permite que el modelo genere datos estructurados en lugar de texto plano. Define tus herramientas en el parámetro tools, especificando el nombre de la función, la descripción y el esquema de parámetros. Cuando el modelo determina que es necesario un llamado a herramienta, devuelve el nombre de la función y los argumentos en formato JSON. Tu aplicación luego ejecuta la función y devuelve el resultado a la conversación. Esto permite flujos de trabajo complejos, extracción de datos y acciones automatizadas. Establece tool_choice para controlar si el modelo debe usar una herramienta o puede elegir libremente.

Modo JSON

Para aplicaciones que requieren formatos de salida estrictos, usa el modo JSON. Establece el parámetro response_format en {"type": "json_object"}. El modelo restringirá su salida a JSON válido. Esto es ideal para analizar datos en tus sistemas backend o generar configuraciones estructuradas. Ten en cuenta que el modo JSON puede reducir ligeramente la flexibilidad de razonamiento del modelo en comparación con el texto de formato libre. Asegúrate de que tu prompt instruya claramente al modelo para que genere solo JSON. Esta función funciona junto con las llamadas a funciones, pero proporciona una interfaz más simple cuando solo necesitas datos estructurados sin definiciones de herramientas.

Uso de tokens y límites

Tu cuenta está limitada a 300 peticiones por minuto y 8 peticiones simultáneas por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Si excedes estos límites, la API devuelve un código de estado 429. Los errores de autenticación devuelven 401 y el crédito insuficiente devuelve 402. El precio es de $0.25 por millón de tokens de entrada y $1.00 por millón de tokens de salida. Los errores y las denegaciones no consumen crédito. La ventana de contexto es de 100,000 tokens en total, incluyendo tanto prompt como respuesta. Gestiona tu uso de tokens cuidadosamente para evitar costos inesperados. El crédito nunca caduca y puedes recargar en cualquier momento usando criptomonedas.

cURL

Copycurl https://api.groknsfw.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Streaming

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)