Guía de inicio rápido de la API de LLM sin censura

Prerrequisitos: tu clave API y URL base

Empieza por generar tu groq ai api key vía la página Obtener clave API. Puedes iniciar sesión con Google o usar un correo electrónico y contraseña para recibir tus credenciales al instante. No se requiere número de teléfono para este proceso.

Configura tu URL base a https://api.groqaiapikey.com/v1 en la configuración de tu cliente. Este endpoint es compatible con los SDK estándar de OpenAI, lo que te permite cambiar de proveedor sin reescribir la lógica de integración. Solo necesitas una clave activa por cuenta, ya que generar una nueva reemplaza la clave anterior inmediatamente.

Primera solicitud: Envío de un prompt a /v1/chat/completions

Envía una solicitud POST a /v1/chat/completions usando tu clave en el Authorization header. El identificador del modelo es simplemente uncensored, que procesa entradas de texto y devuelve salidas de texto sin negaciones de contenido para uso adulto lícito.

Asegúrate de establecer el Content-Type header correctamente para evitar errores 404 comunes. Nuestra API no admite embeddings, generación de imágenes ni procesamiento de audio, así que mantén tus cargas útiles centradas en las completaciones de chat. Este enfoque directo asegura que obtengas precios transparentes de tokens sin la sobrecarga de un proxy multi-proveedor.

Instala el SDK: bibliotecas compatibles con OpenAI

Instala el paquete oficial de Python de OpenAI para interactuar con nuestro endpoint usando métodos familiares. Esta biblioteca maneja la autenticación y la serialización JSON automáticamente cuando la configuras con nuestra URL base. Puedes usar la misma estructura de código que usarías para GPT-4, pero con nuestro modelo uncensored.

Para desarrolladores de JavaScript, instala el openai Paquete Node.js. Ambos entornos te permiten sobrescribir la URL base fácilmente. Esta compatibilidad significa que puedes cambiar entre diferentes proveedores de LLM cambiando solo dos líneas de configuración en tu código.

Gestión de streaming: SSE y uso de tokens

Habilita la transmisión estableciendo stream: true en tus parámetros de solicitud. La API devuelve Eventos Enviados por el Servidor (SSE) que entregan tokens incrementalmente a medida que se generan. Esto reduce la latencia percibida para los usuarios que esperan respuestas largas.

Las estadísticas de uso de tokens se incluyen solo en el fragmento final del stream. Debes acumular estos deltas para calcular el total de tokens consumidos con fines de facturación. Los errores y las denegaciones no generan cargos, por lo que puedes transmitir de forma segura sin preocuparte por costos inesperados por solicitudes fallidas.

Parámetros avanzados: Temperatura, modo JSON y herramientas

Usar temperature y top_p para controlar la aleatoriedad y la creatividad en tus respuestas. Establece response_format para {"type": "json_object"} para forzar una salida JSON estructurada para un análisis fiable en tus aplicaciones. Esto es esencial para construir APIs de chatbot NSFW robustas o herramientas de extracción de datos.

Habilitar llamada de funciones proporcionando un tools array. El modelo soporta definiciones de herramientas estándar y puede elegir llamar a funciones basándose en el contexto de tu prompt. También puedes establecer max_tokens a 16,000, que es la salida máxima por solicitud. La ventana de contexto admite 100,000 tokens en total, incluyendo tanto prompt como finalización.

Límites, errores y detalles de facturación

Esperar un error 401 si tu clave es inválida, un error 402 si tienes crédito prepagado insuficiente y un error 429 si excedes el límite de tasa. Estás limitado a 300 solicitudes por minuto y 8 solicitudes concurrentes por clave. El cuerpo de la solicitud debe permanecer por debajo de 8 MB.

Los precios son $0.15 por 1M de tokens de entrada y $0.50 por 1M de tokens de salida. Las recargas son solo con criptomonedas (USDT en TRC20 o USDC en Base) desde $20 hasta $500. Recibes un bono del 5% en $50, 10% en $100 y 15% en $200. Tu crédito prepagado nunca expira, así que puedes usarlo cuando lo necesites.

cURL

Copycurl https://api.groqaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit?"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)