Премини към основното съдържание
Български— Изберете език
Меню

Променливата на средата XAI_API_KEY

Урок 3 от 14 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Съхранявайте ключа си безопасно
  2. Задаване на XAI_API_KEY
  3. Проверка на конфигурацията
  4. Продукционни среди
  5. Чести грешки
  6. Ключови изводи

Съхранявайте ключа си безопасно

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 на всички Ваши проекти
  • В продукционна среда използвайте вградените тайни на Вашата хостинг платформа