Primera petición en cinco minutos
Integra nuestra API sin censura en tu flujo de trabajo de IA NSFW actualizando tres valores de configuración en tu cliente compatible con OpenAI. Esta guía rápida cubre autenticación, generación de texto y streaming sin dependencias adicionales.
URL base y autenticación
Nuestra API replica la interfaz v1 de OpenAI, lo que te permite cambiar endpoints sin modificar la lógica de tu aplicación. Usa https://api.groknsfw.top/v1 como tu URL base. La autenticación requiere una clave de API válida que se pasa en la cabecera Authorization como token Bearer. Puedes generar esta clave al instante mediante inicio de sesión con Google o correo electrónico en el panel de control. Cada cuenta admite una clave activa a la vez; emitir una nueva invalida la anterior de inmediato. Este modelo de clave única simplifica el control de acceso para la mayoría de entornos de desarrollo y QA.
Primera petición
Envía una petición estándar de completado de chat para probar la conectividad. El identificador del modelo es uncensored, que maneja las negaciones de contenido de forma distinta a los modelos estándar. A continuación hay un ejemplo básico usando la herramienta de línea de comandos curl para verificar que tu clave y URL base son correctas.
curl https://api.groknsfw.top/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."}]
}'
Si recibes una respuesta JSON con choices y usage, tu integración está activa. Revisa el objeto usage para ver el consumo de tokens y realizar un seguimiento preciso de la facturación.
Integración con SDK de Python
Usa el paquete oficial de Python openai para interactuar con nuestro endpoint. Establece los atributos base_url y api_key antes de realizar llamadas. Este enfoque funciona con cualquier biblioteca que admita el esquema de OpenAI, facilitando la migración desde otros proveedores.
from openai import OpenAI
client = OpenAI(base_url="https://api.groknsfw.top/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)
Este fragmento muestra una petición sincrónica. Para la generación de contenido NSFW de alto rendimiento, considera usar clientes asíncronos para manejar múltiples peticiones simultáneas sin bloquear tu hilo principal.
Configuración del SDK de Node.js
Para aplicaciones en JavaScript o TypeScript, configura el SDK de OpenAI para apuntar a nuestra URL base. Esto asegura que tu código de cliente existente funcione sin modificaciones. El ecosistema de Node.js se beneficia de esta compatibilidad, permitiendo prototipado rápido de interfaces de chat NSFW.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groknsfw.top/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);
Asegúrate de usar una versión reciente del SDK que soporte URLs base personalizadas. El objeto de configuración debe incluir estrictamente las propiedades apiKey y baseURL para evitar desajustes de endpoints.
Respuestas en streaming (SSE)
Habilita la generación de tokens en tiempo real estableciendo stream: true en tu petición. La API devuelve un flujo de Server-Sent Events (SSE), entregando tokens a medida que se generan. Esto reduce la latencia percibida para los usuarios finales en aplicaciones de chat.
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)
Analiza los eventos SSE para extraer el contenido delta. El último fragmento del flujo contiene las estadísticas totales de usage, que debes usar para la conciliación precisa de facturación. El streaming no afecta el conteo de tokens ni los precios.
Límites, errores y contexto
Tus peticiones están sujetas a un límite de 300 por minuto y 8 peticiones simultáneas por clave. El tamaño máximo del cuerpo de la petición es de 8 MB, y la ventana de contexto admite hasta 100.000 tokens en total. Los errores se devuelven en formatos HTTP estándar: 401 para claves no válidas, 402 para crédito insuficiente y 429 para límites de peticiones. Los errores de crédito no tienen costo, pero los límites de peticiones requieren que reduzcas la velocidad de las peticiones. La salida máxima por petición es de 32.000 tokens; omitir max_tokens establece un valor predeterminado de 2.048 tokens.
Funciones y límites
Todos los límites y funciones reales de la API en un solo lugar: revísalos antes de recargar.
| Elemento | Valor |
|---|---|
| Formato | compatible con OpenAI: cualquier SDK de OpenAI funciona cambiando la base URL y la clave |
| Autenticación | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.groknsfw.top/v1 |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| ID del modelo | uncensored |
| Modo JSON | response_format: {"type": "json_object"} |
| Salida máxima | hasta el resto de la ventana de 100.000 tokens; max_tokens opcional (sin límite aparte) |
| Parámetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Llamadas a funciones | sí: tools, tool_choice; la respuesta trae tool_calls, también en streaming; resultados como role: tool |
| Ventana de contexto | 100.000 tokens (entrada + salida) |
| Streaming | sí: server-sent events; el último fragmento incluye el uso de tokens |
| Cabeceras | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Límite de peticiones | 300 por minuto por clave |
| Concurrencia | 8 peticiones a la vez por clave |
| Tamaño de petición | hasta 8 MB |
| Facturación | crédito prepago por uso real; errores y rechazos no se cobran |
| Prueba gratis | $0,50 durante 7 días, sin tarjeta · Clave de prueba: 2 solicitudes paralelas, 60 por minuto; límites completos (8 y 300) tras la primera recarga |
| Caducidad | el crédito pagado no caduca, sin suscripción |
| Bono | +5 % desde $50, +10 % desde $100 |
| Precio | $0,25 por 1M tokens de entrada · $1,00 por 1M de salida |
| Recarga | USDT (TRC20) o USDC (Base), cualquier importe entero de $10 a $500 |
| Acceso | Google o correo y contraseña |
| Claves | una clave activa por cuenta; una nueva reemplaza a la anterior |
| Contenido | contenido adulto permitido; se rechaza el contenido sexual con menores |
Códigos de error
Los errores llegan como JSON con un type fijo; las peticiones fallidas o rechazadas no se cobran.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensajes vacíos, parámetro incorrecto o contexto demasiado largo |
401 | missing_key · invalid_key · key_revoked | falta la clave, es incorrecta o fue reemplazada |
402 | no_credit | sin crédito: recarga y sigue al instante |
403 | content_blocked | contenido sexual con menores: rechazado, no se cobra |
404 | not_found | endpoint desconocido |
413 | request_too_large | cuerpo mayor de 8 MB |
429 | rate_limited · concurrency | más de 300/min o 8 en paralelo: espera y reintenta |
503 | upstream_busy | modelo ocupado: reintenta en unos segundos |
Preguntas y respuestas
¿Es esta la API oficial de Grok?
No, somos un servicio independiente que aloja un modelo de pesos abiertos ajustado para respuestas sin censura. Usamos el mismo protocolo de API que OpenAI, pero nuestro modelo no es GPT-4, Grok ni el de ningún otro proveedor. Consulta la documentación del proveedor para los detalles específicos de sus modelos.
¿Cómo obtengo más claves de API?
Cada cuenta tiene límite de una clave de API activa a la vez. Generar una nueva clave en el panel invalidará inmediatamente la clave anterior. Este diseño simplifica la gestión de acceso para desarrolladores individuales y equipos pequeños.
¿Admiten llamadas a funciones?
Sí, la API soporta llamadas a funciones estándar mediante los parámetros <code>tools</code> y <code>tool_choice</code>. También puedes forzar salida JSON usando <code>response_format: { "type": "json_object" }</code> para generación de datos estructurados.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.