Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Miljøvariablen XAI_API_KEY

Lektion 3 af 14 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Opbevar din nøgle sikkert
  2. Indstil XAI_API_KEY
  3. Tjek konfigurationen
  4. Produktionsmiljøer
  5. Almindelige fejl
  6. Vigtige pointer

Opbevar din nøgle sikkert

En API-nøgle må aldrig forekomme som almindelig tekst i din kildekode. Standardtilgangen er at gemme den i en miljøvariabel, som dit program læser ved opstart. Dette adskiller konfiguration fra kode og beskytter dine hemmeligheder.

Indstil XAI_API_KEY

Konventionen, som xAI og alle officielle SDK’er bruger, er variablen XAI_API_KEY. Her er fremgangsmåden for at indstille den på dit system.

Linux og macOS

Tilføj variablen til din shell-profil i terminalen:

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

Hvis du bruger Zsh (standard på macOS), skal du erstatte .bashrc med .zshrc.

Windows (PowerShell)

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

For at gøre den permanent skal du bruge systemets miljøvariabler via Avancerede indstillinger eller køre:

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

.env-fil (lokale projekter)

Til projekter, der bruger et framework (Node.js, Django, Flask), skal du oprette en .env-fil i rodmappen:

XAI_API_KEY=xai-your-key-here

Du skal tilføje .env til din .gitignore-fil, så du ikke pusher dine hemmeligheder til et Git-repository:

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

Tjek konfigurationen

Test, at variablen er tilgængelig:

echo $XAI_API_KEY

Du bør se din nøgle. Hvis kommandoen returnerer en tom linje, skal du genindlæse din shell-profil eller genstarte terminalen.

I Python kan du tjekke det sådan her:

import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")

Produktionsmiljøer

Brug ikke en .env-fil i produktion. Brug i stedet din platforms indbyggede mekanismer:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: En Secret monteret som en miljøvariabel
  • Vercel / Netlify / Railway: Variabler i projektets dashboard
  • GitHub Actions: Repository-hemmeligheder (${{ secrets.XAI_API_KEY }})

Disse systemer krypterer hemmeligheder, når de er inaktive, og injicerer dem kun under kørsel.

Almindelige fejl

  • Ekstra citationstegn i nøglen: Hvis din variabel indeholder bogstavelige citationstegn, vil anmodninger fejle med en autentificeringsfejl.
  • Variabel indstillet i en anden shell: Variabler fra én terminal er ikke tilgængelige i en anden, medmindre de er eksporteret i din profil.
  • Mellemrum omkring =-tegnet: I en .env-fil kan syntaksen XAI_API_KEY = værdi med mellemrum fejle afhængigt af det bibliotek, du bruger.

Vigtige pointer

  • Brug variablen XAI_API_KEY, som genkendes af alle xAI SDK’er
  • Hardkod aldrig nøglen i din kildekode
  • Tilføj .env til .gitignore i alle dine projekter
  • Brug din hosting-platforms indbyggede hemmeligheder i produktion