Cómo crear una clave de API de Grok, más una clave alternativa

Creación de una clave con el proveedor

Somos un servicio independiente y no la API oficial de xAI, por lo que para la clave propia de xAI necesitas las páginas de xAI. El flujo es común para la mayoría de los proveedores, y los nombres de los menús pueden diferir de lo que sigue.

1. Inicia sesión en la consola de desarrolladores del proveedor con tu cuenta.
2. Revisa la sección de facturación. Algunos proveedores requieren un método de pago o un depósito antes de que una clave funcione; lee lo que pide el tuyo.
3. Abre la sección de claves de API y elige crear una nueva clave.
4. Dale un nombre que indique dónde se usará, como el proyecto o el entorno.
5. Copia la clave de inmediato. Muchas consolas muestran el secreto completo solo una vez.
6. Guárdala en un gestor de secretos o en una variable de entorno, nunca en el código fuente.

Si el diseño de la página no coincide, la documentación del proveedor es la autoridad. Cualquier guía escrita hace meses, incluida esta, puede describir una interfaz más antigua.

Obtención de una clave aquí en menos de un minuto

Nuestra clave es para un endpoint compatible con OpenAI que sirve un modelo de pesos abiertos alojado, ajustado para responder sin rechazos de contenido para uso adulto legal. Obtener una toma cinco pasos.

1. Abre la página de clave de API.
2. Regístrate con Google, o con un correo electrónico y contraseña.
3. Haz clic una vez para reclamar tu crédito de prueba de $0,50. Es uno por persona, válido por 7 días y no necesita tarjeta.
4. Copia la clave que se muestra en la página.
5. Ejecuta la llamada de prueba a continuación.

La URL base es https://api.grokaiapikey.com/v1, el ID del modelo es uncensored, y la clave va en un encabezado Authorization: Bearer.

Prueba la clave

Comienza con curl. Si esto devuelve una respuesta JSON, tu clave, URL base y modelo son correctos.

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

En Node, el paquete oficial de OpenAI funciona después de cambiar dos configuraciones.

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokaiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Los usuarios de Python pueden hacer lo mismo con OpenAI(base_url=..., api_key=...). Los métodos disponibles son POST /v1/chat/completions, POST /v1/responses y GET /v1/models.

Configuración de la clave como variable de entorno

Nunca pegues una clave en el código fuente. Ponla en una variable de entorno y léela en tiempo de ejecución. Los comandos varían según el sistema.

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

Para un proyecto, guarda el valor en un archivo .env que esté en .gitignore y cárgalo con el cargador de tu framework. En un servidor, usa el almacén de secretos del host o la configuración de entorno de la plataforma de despliegue. La URL base para este sitio es https://api.grokaiapikey.com/v1 y es seguro guardarla en el código porque no es un secreto.

Si ejecutas varios servicios, asigna una clave distinta a cada uno. Las cuentas con crédito recargado pueden tener hasta 5 claves, por lo que una copia de entorno de pruebas, una de producción y una clave personal de pruebas pueden coexistir, cada una con su propia etiqueta.

Si falla la llamada

Síntoma	Causa probable	Solución
401 No autorizado	Falta la clave o está mal escrita	Verifica el encabezado Bearer y busca un espacio o comilla final
404 No encontrado	URL base incorrecta	La ruta debe ser /v1/chat/completions en el subdominio api.
Error del modelo	Nombre de modelo incorrecto	Usa el ID del modelo uncensored
429 rate_limited	Demasiadas peticiones por minuto	Las claves de prueba permiten 60 por minuto; reduce la velocidad
429 concurrencia	Demasiadas a la vez	Las claves de prueba permiten 2 en vuelo; un streaming ocupa su espacio hasta que termina

Un 429 con un encabezado Retry-After: 5 indica sobrecarga temporal. Espera cinco segundos y reintenta.

Usa el ID de solicitud

Cada respuesta incluye un encabezado X-Request-Id. Regístralo junto a tu propio mensaje de error. Si le preguntas al equipo de soporte sobre una llamada fallida, el ID de petición les permite encontrar esa llamada exacta en lugar de adivinar. En curl, añade -i para imprimir los encabezados de respuesta, y en el SDK de Python puedes leerlos con el helper de respuesta cruda.

Cuando un problema es intermitente, los encabezados también ayudan: X-RateLimit-Limit-Requests y X-RateLimit-Limit-Concurrency muestran los límites que se aplican a tu clave, lo que te dice a simple vista si tienes una clave de prueba o una completa.

Reemplazo o adición de claves

Nunca necesitas pedirle a nadie que rote una clave. En la página de clave de API puedes regenerar la clave cuando quieras, y la clave antigua deja de funcionar al instante. Haz esto en el momento en que una clave caiga en un repositorio público, una captura de pantalla o un chat compartido.

Las cuentas con saldo recargado pueden tener hasta 5 claves. Asigna una etiqueta a cada una, como staging o app móvil, y revoca cualquier clave individual sin afectar a las demás. Usar una clave por entorno es una buena práctica, porque revocar una clave de staging filtrada no afecta a tu tráfico de producción.

Uso de la clave en herramientas existentes

No tienes que escribir código para usar la clave. Muchas interfaces de chat y herramientas de desarrolladores aceptan un endpoint compatible con OpenAI, y SillyTavern es un ejemplo público. La configuración siempre pide los mismos tres valores.

• Base URL o URL de API: https://api.grokaiapikey.com/v1
• Clave de API: la clave que copiaste
• Nombre del modelo: uncensored

Algunas herramientas quieren la ruta completa que termina en /chat/completions; otras la añaden ellas mismas. Si obtienes un 404, prueba con la otra forma. Si la herramienta tiene un menú desplegable de modelos que se queda vacío, escribe el nombre del modelo a mano, o deja que obtenga la lista de GET /v1/models, que devuelve el único ID de modelo.

El streaming funciona a través de la misma configuración. Si las respuestas aparecen todas a la vez en lugar de palabra por palabra, busca un interruptor de streaming en la herramienta.

Mantener una clave a salvo

• Manténla en el lado del servidor. Una clave colocada en JavaScript del navegador o en un paquete de aplicación móvil puede ser leída por cualquiera.
• Cárgala desde una variable de entorno y añade tu archivo env a .gitignore antes del primer commit.
• Establece un hábito de gasto: vigila el encabezado de respuesta X-Balance-USD para que una caída inesperada destaque.
• Usa claves separadas para servicios separados para que puedas revocar una sin causar una interrupción en otro lugar.

Una vez que la llamada de prueba funcione, consulta la documentación para streaming, llamadas a funciones y modo JSON, y revisa la página de precios para ver las tarifas: $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Si estás comparando esto con un proveedor cerrado, nuestro artículo sobre por qué los desarrolladores cambian a modelos sin censura analiza los compromisos.

Una rutina de rotación sencilla

1. En la página de clave de API, crea o regenera la clave que deseas reemplazar. Regenerar hace que la clave antigua deje de funcionar de inmediato, así que hazlo cuando tu código esté listo para tomar el nuevo valor.
2. Actualiza la variable de entorno o el secreto en cada lugar donde se use la clave.
3. Reinicia el servicio y ejecuta la prueba curl de este artículo.
4. Escribe la fecha en tus notas. Un recordatorio de calendario cada pocos meses es suficiente para la mayoría de los proyectos.

Si tienes varias claves etiquetadas después de una recarga, rótalas una a la vez. Revoca primero la clave vinculada a una laptop o a un excompañero, ya que esas son las más propensas a filtrarse.

Más guías

• Clave de API de Grok gratis: qué es real y qué es una estafa
• Clave de API de Claude: Por qué los desarrolladores cambian a modelos sin censura