Променливата на средата XAI_API_KEY
На тази страница
Съхранявайте ключа си безопасно
API ключът никога не трябва да се появява като обикновен текст във Вашия изходен код. Стандартният подход е да го съхранявате в променлива на средата, която Вашето приложение прочита при стартиране. Това разделя конфигурацията от кода и предпазва Вашите тайни.
Задаване на XAI_API_KEY
Конвенцията, използвана от xAI и всички официални SDK, е променливата XAI_API_KEY. Ето как да я зададете във Вашата система.
Linux и macOS
Във Вашия терминал добавете променливата към профила на Вашата обвивка:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
За Zsh (по подразбиране на macOS), заменете .bashrc с .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
За да я направите постоянна, използвайте системните променливи на средата чрез Разширени настройки или изпълнете:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
Файл .env (локални проекти)
За проекти, които използват рамка (Node.js, Django, Flask), създайте файл .env в кореновата директория:
XAI_API_KEY=xai-your-key-here
Трябва да добавите .env към Вашия файл .gitignore, за да не качите Вашите тайни в Git хранилище:
# .gitignore
.env
.env.local
.env.*.local
Проверка на конфигурацията
Тествайте дали променливата е налична:
echo $XAI_API_KEY
Трябва да видите Вашия ключ. Ако командата върне празен ред, презаредете профила на Вашата обвивка или рестартирайте терминала.
В Python можете да я проверите по следния начин:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Продукционни среди
В продукционна среда не използвайте файл .env. Вместо това използвайте вградените механизми на Вашата платформа:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: Secret, монтиран като променлива на средата
- Vercel / Netlify / Railway: променливи в таблото за управление на проекта
- GitHub Actions: тайни на хранилището (
${{ secrets.XAI_API_KEY }})
Тези системи криптират тайните в покой и ги инжектират само по време на изпълнение.
Чести грешки
- Допълнителни кавички в ключа: ако Вашата променлива съдържа буквални кавички, заявките ще се провалят с грешка за удостоверяване
- Променлива, зададена в друга обвивка: променливите от един терминал не са налични в друг, освен ако не са експортирани във Вашия профил
- Интервали около знака
=: във файл.envсинтаксисътXAI_API_KEY = valueс интервали може да се провали в зависимост от библиотеката, която използвате
Ключови изводи
- Използвайте променливата
XAI_API_KEY, разпознавана от всяко xAI SDK - Никога не вграждайте ключа директно във Вашия изходен код
- Добавете
.envкъм.gitignoreна всички Ваши проекти - В продукционна среда използвайте вградените тайни на Вашата хостинг платформа