Η μεταβλητή περιβάλλοντος XAI_API_KEY
Σε αυτήν τη σελίδα
Αποθηκεύστε το κλειδί σας με ασφάλεια
Ένα κλειδί 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όλων των έργων σας. - Σε περιβάλλοντα παραγωγής, χρησιμοποιήστε τους ενσωματωμένους μηχανισμούς μυστικών της πλατφόρμας φιλοξενίας σας.