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

La variable de entorno XAI_API_KEY

Lección 3 de 14 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Almacena tu clave de forma segura
  2. Configura XAI_API_KEY
  3. Comprueba la configuración
  4. Entornos de producción
  5. Errores comunes
  6. Puntos clave

Almacena tu clave de forma segura

Una clave de API nunca debe aparecer en texto plano dentro de tu código fuente. El enfoque estándar consiste en guardarla en una variable de entorno que tu aplicación lee al iniciarse. Esto separa la configuración del código y protege tus secretos.

Configura XAI_API_KEY

La convención que utilizan xAI y todos los SDK oficiales es la variable XAI_API_KEY. A continuación te explicamos cómo configurarla en tu sistema.

Linux y macOS

En tu terminal, añade la variable a tu perfil de shell:

echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc

Si usas Zsh (el predeterminado en macOS), sustituye .bashrc por .zshrc.

Windows (PowerShell)

$env:XAI_API_KEY = "xai-your-key-here"

Para que sea permanente, usa las variables de entorno del sistema a través de la configuración avanzada o ejecuta:

[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")

Archivo .env (proyectos locales)

En proyectos que usan un framework (Node.js, Django, Flask), crea un archivo .env en la raíz:

XAI_API_KEY=xai-your-key-here

Debes añadir .env a tu archivo .gitignore para no subir tus secretos a un repositorio de Git:

# .gitignore
.env
.env.local
.env.*.local

Comprueba la configuración

Prueba que la variable está disponible:

echo $XAI_API_KEY

Deberías ver tu clave. Si el comando devuelve una línea vacía, recarga tu perfil de shell o reinicia la terminal.

En Python, puedes comprobarlo así:

import os
key = os.getenv("XAI_API_KEY")
print("Clave configurada" if key else "Falta la variable")

Entornos de producción

En producción, no uses un archivo .env. Utiliza en su lugar los mecanismos integrados de tu plataforma:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: un Secret montado como variable de entorno
  • Vercel / Netlify / Railway: variables en el panel de control del proyecto
  • GitHub Actions: secretos del repositorio (${{ secrets.XAI_API_KEY }})

Estos sistemas cifran los secretos en reposo y los inyectan solo en tiempo de ejecución.

Errores comunes

  • Comillas adicionales en la clave: si tu variable contiene comillas literales, las peticiones fallarán con un error de autenticación.
  • Variable definida en otra shell: las variables de una terminal no están disponibles en otra a menos que se exporten en tu perfil.
  • Espacios alrededor del signo =: en un archivo .env, la sintaxis XAI_API_KEY = valor con espacios puede fallar dependiendo de la biblioteca que uses.

Puntos clave

  • Usa la variable XAI_API_KEY, reconocida por todos los SDK de xAI.
  • Nunca hardcodees la clave en tu código fuente.
  • Añade .env al .gitignore de todos tus proyectos.
  • En producción, usa los secretos integrados de tu plataforma de alojamiento.