API tal-Ġestjoni: Ġestjoni taċ-Ċwievet u tal-Fatturazzjoni
F'din il-paġna
Immaniġġja l-kont tiegħek mingħajr il-console
L-API tal-Ġestjoni ta’ xAI hija interfaċċa REST iddedikata għall-ġestjoni tal-kont Enterprise tiegħek. Filwaqt li l-API tal-Inferenza (api.x.ai) tsejjaħ il-mudelli, l-API tal-Ġestjoni (management-api.x.ai) tamministra r-riżorsi tiegħek. Id-distinzjoni tista’ tidher żgħira. Mhix. Kull ħaġa li kieku tkun teħtieġ li xi ħadd jiftaħ il-console tal-web u jikklikkja ssir awtomatizzabbli hawnhekk—traċċabbli, riproduċibbli, u integrabbli mal-għodod li t-timijiet tiegħek diġà jużaw.
Ipprovdi u ddur biċ-ċwievet
Il-ħolqien ta’ ċwievet permezz tal-API jħallik tawtomatizza l-provvista għal applikazzjoni jew ambjent ġdid:
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"
}'
Il-parametri f’din it-talba jiddefinixxu bis-sħiħ l-ambitu taċ-ċavetta:
- name: Identifikatur li jista’ jaqrah il-bniedem għaċ-ċavetta
- acls: Lista ta’ permessi (endpoints u mudelli awtorizzati)
- qps/qpm/tpm: Limiti tar-rata kull sekonda, kull minuta, u tokens kull minuta
- expireTime: Data ta’ skadenza awtomatika
Li tissettja expireTime fil-ħolqien hija l-abitudni li tiffrankalek l-akbar problemi fit-tul: ċavetta maħruġa għal pilot ta’ tliet xhur tiskadi waħedha minflok ma tibqa’ tgħix għal dejjem f’fajl ta’ konfigurazzjoni li ħadd ma jaqra aktar.
Id-dawran regolari taċ-ċwievet isegwi l-istess iġjene tas-sigurtà. L-endpoint iddedikat jiġġenera ċavetta sigrieta ġdida u jinvalida dik antika:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Twissija: iċ-ċavetta sigrieta antika tiġi invalidata immedjatament u b’mod permanenti. Ipprepara biex tiddispjega l-valur il-ġdid fil-ġestur tas-sigrieti tiegħek qabel ma tmexxi l-kmand, qatt wara. Tliet endpoints ta’ qari biss jikkompletaw is-sett: GET /auth/teams/{teamId}/api-keys jelenka l-ċwievet kollha għat-tim, GET /auth/api-keys/{apiKeyId}/propagation jivverifika li ċ-ċavetta ġiet propagata fuq in-nodi kollha, u GET /auth/teams/{teamId}/models jelenka l-mudelli aċċessibbli bil-prezzijiet tagħhom. It-tieni wieħed huwa dak li tikkonsulta eżatt wara dawran, meta applikazzjoni għadha tirritorna żbalji ta’ awtentikazzjoni u mhux ċert jekk hix bug fl-applikazzjoni jew sempliċiment dewmien fil-propagazzjoni.
Segwi u kkontrolla l-fatturazzjoni
L-irkupru ta’ informazzjoni dwar il-fatturazzjoni juża endpoint iddedikat:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Tirkupra l-istorja tal-fatturi b’filtru skont il-perjodu, hawnhekk għal Marzu 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Kull fattura ġġorr status wieħed minn PENDING, PAID, FAILED, u WILL_NEVER_BE_CHARGED. Li twassal status FAILED fil-monitoraġġ tiegħek huwa ferm aħjar milli titgħallem dwar l-inċident permezz ta’ interruzzjoni tas-servizz f’għodwa ta’ Tnejn.
Biex tipprevjeni li taqbeż il-baġit, ikkonfigura limitu mensili:
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}'
Jekk topera fuq bażi mħallsa minn qabel (prepaid), iċċekkja l-bilanċ bl-istess mod:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Ftakar li l-krediti mħallsa minn qabel huma mhux rimborsabbli, ħlief jekk meħtieġ legalment. Iddimensjona x-xirjiet tiegħek ibbażat fuq il-konsum osservat fuq diversi ġimgħat, mhux fuq projezzjonijiet ta’ tkabbir ottimistiċi.
Immonitorja l-konsum tiegħek bil-granularità t-tajba
L-endpoint tal-analitika jħallik issegwi l-użu b’granularità fina:
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"]
}
}'
Din it-talba tirritorna l-konsum ta’ tokens kuljum, maqsum skont il-mudell, għal Marzu. Billi tbiddel timeUnit, taqleb minn veduta mensili għal veduta kull minuta: il-valuri possibbli huma MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR, u MINUTE. L-aggregazzjonijiet imorru ferm lil hinn mit-totali sempliċi, b’SUM, AVG, MIN, MAX, P50, P90, P99, u COUNT. Il-perċentili jikkaratterizzaw it-tagħbija b’mod effettiv għax il-medji jillixxaw eżattament dawk il-quċċati li jiddeterminaw il-kapaċità li tassew teħtieġ.
L-API tal-Ġestjoni mbagħad tieħu postha fil-katina tal-għodod tiegħek. Tipprovdi ċwievet minn Terraform jew Pulumi eżatt bħal database, il-pipeline CI/CD tiegħek joħloq ċwievet efimeri għal ambjenti ta’ test imbagħad iħassarhom fit-tmiem tal-eżekuzzjoni, l-iskripts tal-monitoraġġ jallertaw qabel ma jintlaħaq il-limitu tan-nefqa, u d-dashboards interni tiegħek juru l-konsum mingħajr ma bniedem jesporta CSV kull Tnejn.
Punti Ewlenin
- L-API tal-Ġestjoni fuq management-api.x.ai tittratta ċ-ċwievet, il-fatturazzjoni u l-metriċi
- Id-dawran taċ-ċavetta jinvalida b’mod permanenti ċ-ċavetta sigrieta antika
- Il-limiti tan-nefqa jipproteġu kontra li taqbeż il-baġit
- L-analitika tal-użu toffri granularità mill-minuta sax-xahar
- Integra l-API tal-Ġestjoni fl-għodod tal-infrastruttura tiegħek biex tawtomatizza l-amministrazzjoni