Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Η μεταβλητή περιβάλλοντος XAI_API_KEY

Μάθημα 3 / 14 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Αποθηκεύστε το κλειδί σας με ασφάλεια
  2. Ορισμός της XAI_API_KEY
  3. Έλεγχος της διαμόρφωσης
  4. Περιβάλλοντα παραγωγής
  5. Συχνά λάθη
  6. Βασικά σημεία

Αποθηκεύστε το κλειδί σας με ασφάλεια

Ένα κλειδί API δεν πρέπει ποτέ να εμφανίζεται ως απλό κείμενο μέσα στον πηγαίο κώδικά σας. Η καθιερωμένη πρακτική είναι να το αποθηκεύετε σε μια μεταβλητή περιβάλλοντος την οποία η εφαρμογή σας διαβάζει κατά την εκκίνηση. Αυτό διαχωρίζει τη διαμόρφωση από τον κώδικα και προστατεύει τα ευαίσθητα δεδομένα σας.

Ορισμός της XAI_API_KEY

Η σύμβαση που χρησιμοποιείται από την xAI και όλα τα επίσημα SDK είναι η μεταβλητή XAI_API_KEY. Ακολουθεί ο τρόπος ορισμού της στο σύστημά σας.

Linux και macOS

Στο τερματικό σας, προσθέστε τη μεταβλητή στο προφίλ του κελύφους (shell profile):

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 (για τοπικά έργα)

Για έργα που χρησιμοποιούν κάποιο framework (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: μεταβλητές στον πίνακα ελέγχου (dashboard) του έργου
  • GitHub Actions: μυστικά αποθετηρίου (${{ secrets.XAI_API_KEY }})

Αυτά τα συστήματα κρυπτογραφούν τα μυστικά σε κατάσταση ηρεμίας (at rest) και ταενσωματώνουν μόνο κατά τη διάρκεια εκτέλεσης (runtime).

Συχνά λάθη

  • Επιπλέον εισαγωγικά στο κλειδί: αν η μεταβλητή σας περιέχει κυριολεκτικά εισαγωγικά, τα αιτήματα θα αποτύχουν με σφάλμα πιστοποίησης.
  • Μεταβλητή ορισμένη σε άλλο κέλυφος: οι μεταβλητές από ένα τερματικό δεν είναι διαθέσιμες σε άλλο, εκτός αν έχουν εξαχθεί (exported) στο προφίλ σας.
  • Κενά γύρω από το σημάδι =: σε ένα αρχείο .env, η σύνταξη XAI_API_KEY = value με κενά μπορεί να αποτύχει, ανάλογα με τη βιβλιοθήκη που χρησιμοποιείτε.

Βασικά σημεία

  • Χρησιμοποιήστε τη μεταβλητή XAI_API_KEY, την οποία αναγνωρίζει κάθε SDK της xAI.
  • Μην ενσωματώνετε ποτέ το κλειδί απευθείας στον πηγαίο κώδικά σας.
  • Προσθέστε το .env στο .gitignore όλων των έργων σας.
  • Σε περιβάλλοντα παραγωγής, χρησιμοποιήστε τους ενσωματωμένους μηχανισμούς μυστικών της πλατφόρμας φιλοξενίας σας.