Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Varijabla okruženja XAI_API_KEY

Lekcija 3 od 14 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Sigurno pohrani svoj ključ
  2. Postavi XAI_API_KEY
  3. Provjeri konfiguraciju
  4. Produkcijska okruženja
  5. Uobičajene pogreške
  6. Ključne točke

Sigurno pohrani svoj ključ

API ključ nikada ne smije biti vidljiv u izvornom kodu kao običan tekst. Standardni pristup je pohraniti ga u varijablu okruženja koju tvoja aplikacija čita pri pokretanju. Time odvajaš konfiguraciju od koda i štitiš svoje tajne.

Postavi XAI_API_KEY

Konvencija koju koriste xAI i svi službeni SDK-ovi je varijabla XAI_API_KEY. Evo kako je postaviti na svom sustavu.

Linux i macOS

U svom terminalu dodaj varijablu u profil svoje ljuske:

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

Za Zsh (zadano na macOS-u), zamijeni .bashrc s .zshrc.

Windows (PowerShell)

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

Da bi postavka bila trajna, upotrijebi sistemske varijable okruženja putem Naprednih postavki ili pokreni:

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

.env datoteka (lokalni projekti)

Za projekte koji koriste framework (Node.js, Django, Flask), stvori .env datoteku u korijenskom direktoriju:

XAI_API_KEY=xai-your-key-here

Moraš dodati .env u svoju .gitignore datoteku kako ne bi slučajno poslao svoje tajne u Git repozitorij:

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

Provjeri konfiguraciju

Testiraj je li varijabla dostupna:

echo $XAI_API_KEY

Trebao bi vidjeti svoj ključ. Ako naredba vrati prazan redak, ponovno učitaj profil ljuske ili ponovno pokreni terminal.

U Pythonu to možeš provjeriti ovako:

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

Produkcijska okruženja

U produkciji nemoj koristiti .env datoteku. Umjesto toga upotrijebi ugrađene mehanizme svoje platforme:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: Tajna (Secret) montirana kao varijabla okruženja
  • Vercel / Netlify / Railway: varijable na nadzornoj ploči projekta
  • GitHub Actions: tajne repozitorija (${{ secrets.XAI_API_KEY }})

Ovi sustavi šifriraju tajne u mirovanju i ubacuju ih isključivo tijekom izvršavanja.

Uobičajene pogreške

  • Dodatni navodnici u ključu: ako tvoja varijabla sadrži doslovne navodnike, zahtjevi će neuspjeti s pogreškom autentifikacije
  • Varijabla postavljena u drugoj ljusci: varijable iz jednog terminala nisu dostupne u drugom osim ako nisu izvezene u tvom profilu
  • Razmaci oko znaka =: u .env datoteci, sintaksa XAI_API_KEY = vrijednost s razmacima može ne uspjeti, ovisno o biblioteci koju koristiš

Ključne točke

  • Koristi varijablu XAI_API_KEY, koju prepoznaje svaki xAI SDK
  • Nikada nemoj hardkodirati ključ u svom izvornom kodu
  • Dodaj .env u .gitignore svih svojih projekata
  • U produkciji koristi ugrađene tajne svoje hosting platforme