Δημιουργία κλειδιού API
Σε αυτήν τη σελίδα
Πρόγραμμα πρόσβασης στο Grok
Το κλειδί API είναι το διακριτικό πιστοποίησης που επιτρέπει στις εφαρμογές σας να επικοινωνούν με τα μοντέλα Grok. Χωρίς αυτό, κανένα αίτημα δεν διεκπεραιώνεται. Αυτό το μάθημα σας καθοδηγεί στη δημιουργία και τη διαχείριση των κλειδιών σας στην κονσόλα της xAI.
Άνοιγμα της κονσόλας
Μεταβείτε στο console.x.ai και συνδεθείτε με τον λογαριασμό που δημιουργήσατε στο προηγούμενο βήμα. Η κονσόλα αποτελεί τον κεντρικό σας πίνακα ελέγχου για τη διαχείριση κλειδιών, την παρακολούθηση της χρήσης και τη ρύθμιση της χρέωσης.
Στο πλευρικό μενού, ανοίξτε την ενότητα API Keys (πλήρης διαδρομή: console.x.ai/team/default/api-keys).
Δημιουργία του πρώτου σας κλειδιού
Κάντε κλικ στο Create API Key. Μπορείτε να δώσετε σε κάθε κλειδί μια περιγραφική ονομασία για να αναγνωρίζετε τη χρήση του:
dev-localγια το περιβάλλον ανάπτυξής σαςprod-backendγια τον διακομιστή παραγωγής σαςtest-ciγια τη γραμμή συνεχούς ένταξής σας (CI pipeline)
Το κλειδί εμφανίζεται μόνο μία φορά, κατά τη δημιουργία του. Αντιγράψτε το αμέσως και αποθηκεύστε το σε ασφαλές σημείο (σε έναν διαχειριστή κωδικών πρόσβασης ή σε θησαυροφυλάκιο μυστικών). Εάν χάσετε ένα κλειδί, θα πρέπει να δημιουργήσετε ένα νέο.
Μορφή κλειδιού
Τα κλειδιά API της xAI ξεκινούν με το πρόθεμα xai- ακολουθούμενο από μια αλφαριθμητική συμβολοσειρά. Αυτό το πρόθεμα σας βοηθά να τα εντοπίζετε γρήγορα στα αρχεία διαμόρφωσής σας και να τα ανιχνεύετε σε περίπτωση accidental αποκάλυψης στον πηγαίο κώδικα.
Βέλτιστες πρακτικές διαχείρισης
Ένα κλειδί ανά περιβάλλον
Δημιουργήστε ξεχωριστά κλειδιά για κάθε πλαίσιο λειτουργίας. Εάν ένα κλειδί διαρρεύσει, μπορείτε να το ανακαλέσετε χωρίς να επηρεάσετε τα άλλα περιβάλλοντά σας.
Τακτική ανανέωση
Ανανεώνετε τα κλειδιά σας περιοδικά, ειδικά για τα περιβάλλοντα παραγωγής. Η διαδικασία είναι απλή: δημιουργήστε ένα νέο κλειδί, ενημερώστε την εφαρμογή σας και, στη συνέχεια, διαγράψτε το παλιό.
Έλεγχος πριν τη κοινοποίηση
Πριν κοινοποιήσετε ένα έργο, βεβαιωθείτε ότι κανένα κλειδί δεν είναι ενσωματωμένο (hard-coded) στον πηγαίο κώδικα. Χρησιμοποιήστε αρχεία .env τα οποία κρατάτε εκτός ελέγχου εκδόσεων (προσθέστε το .env στο αρχείο .gitignore).
Χρέωση συνδεδεμένη με τα κλειδιά
Κάθε κλήση API που πραγματοποιείται με ένα κλειδί καταμετράται και χρεώνεται. Η xAI προσφέρει δύο τρόπους λειτουργίας:
- Προπληρωμένες πιστώσεις: αγοράζετε πιστώσεις εκ των προτέρων και οι κλήσεις αφαιρούνται άμεσα
- Μηνιαία χρέωση: η χρήση πέραν των πιστώσεών σας χρεώνεται στο τέλος του μήνα
Ελέγξτε τις πληροφορίες χρέωσής σας στην κονσόλα πριν αρχίσετε να χρησιμοποιείτε το API, καθώς οι τιμολογήσεις δεν μπορούν να τροποποιηθούν αναδρομικά.
Δοκιμάστε το κλειδί άμεσα
Αφιερώστε τριάντα δευτερόλεπτα για να επικυρώσετε το κλειδί πριν το ενσωματώσετε σε ένα έργο. Η απλούστερη δοκιμή ζητά τη λίστα των μοντέλων:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Μια απόκριση JSON που παραθέτει τα μοντέλα επιβεβαιώνει ότι το κλειδί είναι ενεργό και η χρέωση λειτουργεί σωστά. Ένα σφάλμα 401 σημαίνει ότι το κλειδί αντιγράφηκε λανθασμένα· ένα σφάλμα 403 υποδεικνύει πρόβλημα με τα δικαιώματα ή τις πιστώσεις. Η διάγνωση του προβλήματος εδώ, στην πηγή, σας γλιτώνει από μια διαδικασία εντοπισμού σφαλμάτων αργότερα, μέσα στον κώδικα της εφαρμογής σας.
Βασικά σημεία
- Δημιουργείτε κλειδιά στο console.x.ai/team/default/api-keys
- Ξεκινούν με
xai-και εμφανίζονται μόνο μία φορά - Δημιουργήστε ένα κλειδί ανά περιβάλλον και αποθηκεύστε τα σε θησαυροφυλάκιο μυστικών
- Ελέγξτε τον τρόπο χρέωσής σας πριν από οποιαδήποτε κλήση API
- Επικυρώστε κάθε νέο κλειδί με μια κλήση στο
/v1/modelsπριν το ενσωματώσετε