Management API: Διαχείριση κλειδιών και χρέωσης
Σε αυτήν τη σελίδα
Διαχειριστείτε τον λογαριασμό σας χωρίς την κονσόλα
Το xAI Management API είναι μια διεπαφή REST αφιερωμένη στη διαχείριση του εταιρικού σας λογαριασμού. Ενώ το Inference API (api.x.ai) καλεί μοντέλα, το Management API (management-api.x.ai) διαχειρίζεται τους πόρους σας. Η διάκριση μπορεί να φαίνεται ασήμαντη. Δεν είναι. Οτιδήποτε θα απαιτούσε διαφορετικά κάποιον να ανοίξει την web κονσόλα και να κάνει κλικ, γίνεται εδώ αυτοματοποιήσιμο—ιχνηλατήσιμο, αναπαραγώγιμο και ενσωματώσιμο στα εργαλεία που χρησιμοποιούν ήδη οι ομάδες σας.
Δημιουργία και εναλλαγή κλειδιών
Η δημιουργία κλειδιών μέσω του API σας επιτρέπει να αυτοματοποιήσετε την προμήθεια για μια νέα εφαρμογή ή περιβάλλον:
curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "cle-production-chatbot",
"acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
"qps": 10,
"qpm": 100,
"tpm": 1000000,
"expireTime": "2026-12-31T23:59:59Z"
}'
Οι παράμετροι σε αυτό το αίτημα ορίζουν πλήρως το πεδίο εφαρμογής του κλειδιού:
- name: Αναγνώσιμο από άνθρωπο αναγνωριστικό για το κλειδί
- acls: Λίστα δικαιωμάτων (εξουσιοδοτημένα endpoints και μοντέλα)
- qps/qpm/tpm: Όρια ρυθμού ανά δευτερόλεπτο, ανά λεπτό και tokens ανά λεπτό
- expireTime: Ημερομηνία αυτόματης λήξης
Ο ορισμός του expireTime κατά τη δημιουργία είναι η συνήθεια που θα σας γλιτώσει τους περισσότερους μπελάδες μακροπρόθεσμα: ένα κλειδί που εκδίδεται για μια πιλοτική φάση τριών μηνών λήγει μόνο του, αντί να επιβιώνει επ’ αόριστον σε ένα αρχείο διαμόρφωσης που κανείς δεν διαβάζει πια.
Η τακτική εναλλαγή κλειδιών ακολουθεί την ίδια υγιεινή ασφαλείας. Το ειδικό endpoint δημιουργεί ένα νέο μυστικό κλειδί και ακυρώνει το παλιό:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Προειδοποίηση: το παλιό μυστικό κλειδί ακυρώνεται άμεσα και οριστικά. Προετοιμαστείτε να αναπτύξετε τη νέα τιμή στον διαχειριστή μυστικών σας πριν εκτελέσετε την εντολή, ποτέ μετά. Τρία endpoints μόνο για ανάγνωση ολοκληρώνουν το σύνολο: το GET /auth/teams/{teamId}/api-keys παραθέτει όλα τα κλειδιά για την ομάδα, το GET /auth/api-keys/{apiKeyId}/propagation επαληθεύει ότι το κλειδί έχει διαδοθεί σε όλους τους κόμβους, και το GET /auth/teams/{teamId}/models παραθέτει τα προσβάσιμα μοντέλα με τις τιμές τους. Το δεύτερο είναι αυτό που συμβουλεύεστε αμέσως μετά από μια εναλλαγή, όταν μια εφαρμογή επιστρέφει ακόμα σφάλματα πιστοποίησης και δεν είστε σίγουροι αν πρόκειται για σφάλμα της εφαρμογής ή απλώς για καθυστέρηση διάδοσης.
Παρακολούθηση και έλεγχος χρέωσης
Η ανάκτηση πληροφοριών χρέωσης χρησιμοποιεί ένα ειδικό endpoint:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Ανακτάτε το ιστορικό τιμολογίων με φιλτράρισμα περιόδου, εδώ για τον Μάρτιο του 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Κάθε τιμολόγιο φέρει μια κατάσταση μεταξύ των PENDING, PAID, FAILED και WILL_NEVER_BE_CHARGED. Η αποκάλυψη μιας κατάστασης FAILED στην παρακολούθησή σας είναι πολύ καλύτερο από το να μαθαίνετε για το περιστατικό μέσω μιας διακοπής υπηρεσίας ένα πρωί Δευτέρας.
Για να αποτρέψετε υπερβάσεις προϋπολογισμού, διαμορφώστε ένα μηνιαίο όριο:
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 5000}'
Εάν λειτουργείτε με προπληρωμή, ελέγξτε το υπόλοιπο με τον ίδιο τρόπο:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Θυμηθείτε ότι οι προπληρωμένες πιστώσεις είναι μη επιστρέψιμες, εκτός εάν απαιτείται νομικά. Προσαρμόστε τις αγορές σας με βάση την κατανάλωση που παρατηρήθηκε κατά τη διάρκεια αρκετών εβδομάδων, όχι σε αισιόδοξες προβλέψεις ανάπτυξης.
Παρακολουθήστε την κατανάλωσή σας στη σωστή λεπτομέρεια
Το endpoint αναλυτικών στοιχείων σας επιτρέπει να παρακολουθείτε τη χρήση με λεπτομερή κοκκοποίηση:
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}],
"groupBy": ["model"]
}
}'
Αυτό το αίτημα επιστρέφει την ημερήσια κατανάλωση tokens, αναλυόμενη ανά μοντέλο, για τον Μάρτιο. Αλλάζοντας το timeUnit, μεταβαίνετε από μια μηνιαία προβολή σε μια προβολή ανά λεπτό: οι πιθανές τιμές είναι MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR και MINUTE. Οι συσσωρεύσεις πηγαίνουν πολύ πέρα από τους απλούς συνολικούς αριθμούς, με SUM, AVG, MIN, MAX, P50, P90, P99 και COUNT. Τα εκατοστημόρια χαρακτηρίζουν αποτελεσματικά το φορτίο, επειδή οι μέσοι όροι εξομαλύνουν ακριβώς εκείνες τις αιχμές που καθορίζουν την χωρητικότητα που πραγματικά χρειάζεστε.
Το Management API καταλαμβάνει τότε τη θέση του στην εργαλειοθήκη σας. Προμηθεύεστε κλειδιά από το Terraform ή το Pulumi ακριβώς όπως μια βάση δεδομένων, η γραμμή CI/CD σας δημιουργεί εφήμερα κλειδιά για περιβάλλοντα δοκιμών και τα διαγράφει στο τέλος της εκτέλεσης, τα σενάρια παρακολούθησης ειδοποιούν πριν επιτευχθεί το όριο δαπανών, και οι εσωτερικοί πίνακες ελέγχου σας εμφανίζουν την κατανάλωση χωρίς έναν άνθρωπο να εξάγει ένα CSV κάθε Δευτέρα.
Βασικά σημεία
- Το Management API στο management-api.x.ai διαχειρίζεται κλειδιά, χρέωση και μετρικές
- Η εναλλαγή κλειδιών ακυρώνει οριστικά το παλιό μυστικό κλειδί
- Τα όρια δαπανών προστατεύουν από υπερβάσεις προϋπολογισμού
- Τα αναλυτικά στοιχεία χρήσης προσφέρουν λεπτομέρεια από το λεπτό έως τον μήνα
- Ενσωματώστε το Management API στα εργαλεία υποδομής σας για να αυτοματοποιήσετε τη διαχείριση