La variable de entorno XAI_API_KEY
En esta página
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 sintaxisXAI_API_KEY = valorcon 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
.enval.gitignorede todos tus proyectos. - En producción, usa los secretos integrados de tu plataforma de alojamiento.