Management API: võtmete ja arvelduse haldamine
Sellel lehel
Halda oma kontot ilma konsoolita
xAI Management API on REST-liides, mis on mõeldud spetsiaalselt sinu ettevõtte konto haldamiseks. Kui Inference API (api.x.ai) kutsub mudeleid, siis Management API (management-api.x.ai) haldab sinu ressursse. See erinevus võib tunduda tühine, kuid seda see ei ole. Kõik, mis muidu nõuaks kellegi poolt veebikonsooli avamist ja klõpsimist, muutub siin automatiseeritavaks – jälgitavaks, korratavaks ja integreeritavaks tööriistadega, mida sinu meeskonnad juba kasutavad.
Loo ja uuenda võtmeid
Võtmete loomine API kaudu võimaldab automatiseerida uue rakenduse või keskkonna varustamist:
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"
}'
Selle päringu parameetrid määravad võtme ulatuse täielikult:
- name: Inimesele loetav võtme identifikaator
- acls: Lubade loend (autoriseeritud lõpp-punktid ja mudelid)
- qps/qpm/tpm: Kiiruse piirangud sekundi, minuti ja tokenite kohta minutis
- expireTime: Automaatne aegumiskuupäev
expireTime määramine loomise hetkel on harjumus, mis säästab sind pikas perspektiivis kõige rohkem vaevast: kolmeks kuuks mõeldud pilootprojekti võti aegub ise, selle asemel et jääda määramata ajaks konfiguratsioonifaili, mida keegi enam ei loe.
Regulaarne võtmete rotatsioon järgib sama turvahügieeni. Spetsiaalne lõpp-punkt genereerib uue salajase võtme ja tunnistab vana kehtetuks:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Hoiatus: vana salajane võti tunnistatakse koheselt ja pöördumatult kehtetuks. Valmista ette uue väärtuse kasutuselevõtt oma saladuste halduris enne käsu käivitamist, mitte pärast seda. Kolm ainult lugemiseks mõeldud lõpp-punkti täiendavad komplekti: GET /auth/teams/{teamId}/api-keys loetleb kõik meeskonna võtmed, GET /auth/api-keys/{apiKeyId}/propagation kontrollib, kas võti on levitatud kõigile sõlmedele, ja GET /auth/teams/{teamId}/models loetleb ligipääsetavad mudelid koos nende hindadega. Teist neist konsulteerid kohe pärast rotatsiooni, kui rakendus tagastab endiselt autentimisvigu ja sa ei ole kindel, kas tegemist on rakenduse veaga või lihtsalt levitusviivitusega.
Jälgi ja kontrolli arveldust
Arveldusteabe hankimine kasutab spetsiaalset lõpp-punkti:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Saad arve ajaloo kätte perioodi filtriga, siin märtsi 2026 jaoks:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Igal arvel on olek ühest järgmistest: PENDING, PAID, FAILED ja WILL_NEVER_BE_CHARGED. Oleku FAILED ilmumine sinu monitooringusse on palju parem kui intsidentist teada saamine teenuse katkemise kaudu esmaspäeva hommikul.
Eelarve ületamise vältimiseks seadista kuupiirang:
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}'
Kui tegutsetud ettemaksuga, kontrolli saldot samal viisil:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Pea meeles, et ettemakstud krediidid on tagastamatud, välja arvatud juhul, kui seadus seda nõuab. Planeeri oma ostud mitme nädala jooksul täheldatud tarbimise põhjal, mitte optimistlike kasvuprognooside põhjal.
Jälgi oma tarbimist õige granulaarsusega
Analüütika lõpp-punkt võimaldab jälgida kasutust peene granulaarsusega:
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"]
}
}'
See päring tagastab märtsikuu päevase tokenite tarbimise, jaotatuna mudelite kaupa. Muutes timeUnit väärtust, lülitud kuuvaatelt minutilisele vaatele: võimalikud väärtused on MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR ja MINUTE. Agregatsioonid ulatuvad kaugemale lihtsatest summadest, hõlmates SUM, AVG, MIN, MAX, P50, P90, P99 ja COUNT. Protsentiilid iseloomustavad koormust tõhusalt, sest keskmised siluvad välja just need tipphetked, mis määravad tegelikult vajaliku võimsuse.
Management API leiab seejärel oma koha sinu tööriistaketis. Varustad võtmeid Terraformi või Pulumi kaudu täpselt nagu andmebaasi, sinu CI/CD torustik loob testkeskkondadele ajutised võtmed ja kustutab need täitmise lõpus, monitooringuskriptid annavad häire enne kulupiiri saavutamist ja sinu sisemised armatuurlauad kuvavad tarbimist ilma, et inimene peaks iga esmaspäev CSV-faili eksportima.
Peamised punktid
- Management API aadressil management-api.x.ai haldab võtmeid, arveldust ja mõõdikuid
- Võtme rotatsioon tunnistab vana salajase võtme pöördumatult kehtetuks
- Kulupiirangud kaitsevad eelarve ületamise eest
- Kasutusanalüütika pakub granulaarsust minutist kuuni
- Integreeri Management API oma infrastruktuuri tööriistadesse, et automatiseerida haldust