Generar una clave de API
En esta página
Acceso programático a Grok
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-localpara tu entorno de desarrolloprod-backendpara tu servidor de produccióntest-cipara 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/modelsantes de integrarla