Ir al contenido principal
Español— Elegir un idioma
Menú

Generar una clave de API

Lección 2 de 14 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Acceso programático a Grok
  2. Abrir la consola
  3. Crear tu primera clave
  4. Buenas prácticas de gestión
  5. Facturación vinculada a las claves
  6. Probar la clave de inmediato
  7. Puntos clave

Acceso programático a Grok

Clave de API creada en la consola de xAI La clave de API es el token de autenticación que permite a tus aplicaciones comunicarse con los modelos de Grok. Sin ella, ninguna solicitud prosperará. Esta lección te guía paso a paso en la creación y gestión de tus claves dentro de la consola de xAI.

Abrir la consola

Accede a console.x.ai e inicia sesión con la cuenta que creaste en el paso anterior. La consola es tu panel central para gestionar claves, supervisar el uso y configurar la facturación.

En el menú lateral, abre API Keys (ruta completa: console.x.ai/team/default/api-keys).

Crear tu primera clave

Haz clic en Create API Key. Puedes asignar a cada clave un nombre descriptivo para identificar su propósito:

  • dev-local para tu entorno de desarrollo
  • prod-backend para tu servidor de producción
  • test-ci para tu tubería de integración continua

La clave se muestra una única vez, justo en el momento de crearla. Cópiala de inmediato y guárdala en un lugar seguro (un gestor de contraseñas o una bóveda de secretos). Si pierdes una clave, tendrás que generar una nueva.

Formato de la clave

Las claves de API de xAI comienzan con el prefijo xai- seguido de una cadena alfanumérica. Este prefijo te ayuda a localizarlas rápidamente en tus archivos de configuración y a detectarlas si quedan expuestas accidentalmente en el código fuente.

Buenas prácticas de gestión

Una clave por entorno

Crea claves separadas para cada contexto. Si una clave se filtra, podrás revocarla sin afectar a tus otros entornos.

Rotación periódica

Renueva tus claves periódicamente, especialmente en entornos de producción. El procedimiento es sencillo: crea una nueva clave, actualiza tu aplicación y, a continuación, elimina la antigua.

Verificar antes de compartir

Antes de compartir un proyecto, asegúrate de que no haya ninguna clave codificada directamente en el código fuente. Utiliza archivos .env mantenidos fuera del control de versiones (añade .env a tu .gitignore).

Facturación vinculada a las claves

Cada llamada a la API realizada con una clave se cuenta y se factura. xAI ofrece dos modalidades:

  • Créditos por adelantado: compras créditos previamente y las llamadas se descuentan de inmediato
  • Facturación mensual: el uso que exceda tus créditos se factura a finales de mes

Consulta la información de facturación en la consola antes de empezar a utilizar la API, ya que las facturas no pueden modificarse con carácter retroactivo.

Probar la clave de inmediato

Tómate treinta segundos para validar la clave antes de integrarla en un proyecto. La prueba más sencilla consiste en solicitar la lista de modelos:

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer xai-your-key"

Una respuesta JSON que enumere los modelos confirma que la clave está activa y que la facturación funciona correctamente. Un error 401 indica que la clave se copió incorrectamente; un 403 señala un problema de permisos o de créditos. Diagnosticarlo aquí, en el origen, te ahorrará una sesión de depuración más adelante en medio del código de tu aplicación.

Puntos clave

  • Creas las claves en console.x.ai/team/default/api-keys
  • Comienzan por xai- y se muestran una única vez
  • Crea una clave por entorno y guárdalas en una bóveda de secretos
  • Comprueba tu modalidad de facturación antes de realizar cualquier llamada a la API
  • Valida cada nueva clave con una llamada a /v1/models antes de integrarla