Βασικό URL και πρώτο αίτημα
Σε αυτήν τη σελίδα
Το Management API: Ένα ξεχωριστό επίπεδο ελέγχου
Το Management API της xAI διαφέρει από το inference API που χρησιμοποιείτε για να στείλετε prompts στο Grok. Σας επιτρέπει να διαχειρίζεστε τους πόρους σας: δημιουργία και διαχείριση κλειδιών API, ρύθμιση χρέωσης, παρακολούθηση χρήσης και έλεγχο πρόσβασης της ομάδας σας. Όλη αυτή η διαχείριση πραγματοποιείται μέσω ενός αποκλειστικού URL.
Βασικό URL
Αυτός ο διαχωρισμός δεν είναι λεπτομέρεια υλοποίησης: αντανακλά μια θεμελιώδη διαφορά μεταξύ των δύο API. Το ένα καταναλώνει tokens και εκτελεί μοντέλα· το άλλο διαχειρίζεται, χρεώνει και χορηγεί δικαιώματα. Η διατήρησή τους σε δύο διαφορετικούς τομείς και με δύο σετ κλειδιών εγγυάται ότι ένα κλεμμένο κλειδί εφαρμογής δεν θα μπορέσει ποτέ να δημιουργήσει άλλα κλειδιά ή να διαβάσει τις πληροφορίες χρέωσής σας.
https://management-api.x.ai
Μην το συγχέετε με το https://api.x.ai, το οποίο είναι το URL για κλήσεις inference (ολοκληρώσεις chat, embeddings κ.λπ.). Όλα τα αιτήματα διαχείρισης—κλειδιά, χρέωση, αναλυτικά στοιχεία—διέρχονται από το management-api.x.ai.
Πιστοποίηση στο Management API
Ο μηχανισμός πιστοποίησης είναι ίδιος—ένα Bearer token στην κεφαλίδα Authorization—αλλά το ίδιο το κλειδί διαφέρει. Αυτή είναι η πιο συχνή σύγχυση κατά την εκκίνηση και οδηγεί σε ένα απόλυτα ακατανόητο σφάλμα 401: τίποτα στο μήνυμα σφάλματος δεν υποδεικνύει ότι απλώς παρουσιάσατε το σωστό κλειδί στο λάθος API.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Αυτό το αίτημα επικύρωσης (GET /auth/management-keys/validation) σας επιτρέπει να επαληθεύσετε ότι το κλειδί διαχείρισής σας είναι έγκυρο και ενεργό. Αποτελεί το απλούστερο σημείο εισόδου για να δοκιμάσετε τη διαμόρφωσή σας.
Κλειδί διαχείρισης έναντι κλειδιού inference
- Κλειδί διαχείρισης: χορηγεί πρόσβαση στα endpoints του
management-api.x.ai(διαχείριση, χρέωση, αναλυτικά στοιχεία) - Κλειδί inference: χορηγεί πρόσβαση στα endpoints του
api.x.ai(chat, embeddings, εικόνες)
Και οι δύο τύποι κλειδιών δημιουργούνται από την κονσόλα της xAI, αλλά τα πεδία εφαρμογής τους διαφέρουν. Ένα κλειδί inference δεν μπορεί να accesses endpoints διαχείρισης και το αντίστροφο.
Δομή endpoint
Τα endpoints του Management API ακολουθούν μια λογική οργάνωση:
/auth/teams/{teamId}/api-keys— Διαχείριση κλειδιών API/auth/api-keys/{apiKeyId}— Λειτουργίες σε ένα συγκεκριμένο κλειδί/auth/teams/{teamId}/models— Προσβάσιμα μοντέλα/auth/teams/{teamId}/endpoints— Διαθέσιμα endpoints ACL/v1/billing/teams/{teamId}/— Χρέωση και αναλυτικά στοιχεία
Η παράμετρος teamId είναι το αναγνωριστικό της ομάδας σας στην κονσόλα της xAI και δομεί σχεδόν όλα τα endpoints. Κάθε ομάδα διαθέτει τα δικά της κλειδιά, ποσοστώσεις και ρυθμίσεις χρέωσης—καθιστώντας τη τη φυσική μονάδα απομόνωσης: ο διαχωρισμός δύο έργων σε δύο ομάδες διαχωρίζει επίσης τους προϋπολογισμούς και την πρόσβασή τους, χωρίς καμία πρόσθετη διαμόρφωση.
Το πρώτο σας αίτημα διαχείρισης
Ακολουθεί ένα πλήρες παράδειγμα για την επικύρωση της διαμόρφωσής σας:
# Ορίστε το κλειδί διαχείρισής σας
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Επικυρώστε το κλειδί
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Εάν η απόκριση περιλαμβάνει τις πληροφορίες της ομάδας και του κλειδιού σας, η διαμόρφωσή σας λειτουργεί. Εάν λάβετε σφάλμα 401, επαληθεύστε ότι χρησιμοποιείτε κλειδί διαχείρισης (και όχι κλειδί inference).
Βασικά σημεία
- Το Management API χρησιμοποιεί το
https://management-api.x.ai, το οποίο διαφέρει από τοhttps://api.x.ai - Η πιστοποίηση χρησιμοποιεί ένα Bearer token στην κεφαλίδα
Authorization - Τα κλειδιά διαχείρισης και τα κλειδιά inference έχουν ξεχωριστά πεδία εφαρμογής
- Το endpoint
GET /auth/management-keys/validationσας επιτρέπει να δοκιμάσετε τη διαμόρφωσή σας - Όλα τα endpoints διαχείρισης οργανώνονται γύρω από το
teamId