API Bainistíochta: Bainistiú Eochracha agus Billithe
Ar an leathanach seo
Bainistigh do chuntas gan an consól
Is comhéadan REST é API Bainistíochta xAI atá tiomnaithe do chuntas Fiontar a bhainistiú. Cé go ndéanann API Inference (api.x.ai) glaoch ar mhúnlaí, riarann API Bainistíochta (management-api.x.ai) do chuid acmhainní. D’fhéadfadh sé go mbeadh an difríocht cosúil le mioncheist. Ní hea. Aon rud a d’éileodh ar dhuine an consól gréasáin a oscailt agus cliceáil, is féidir é a uathoibriú anseo—inrianaithe, in-atáirgthe, agus in-inteangraithe leis na huirlisí a úsáideann do fhoirne cheana féin.
Eochracha a sholáthar agus a rothlú
Trí eochracha a chruthú tríd an API, is féidir leat soláthar a uathoibriú d’fheidhmchlár nó do thimpeallacht nua:
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"
}'
Sainíonn na paraiméadair san iarratas seo raon feidhme na heochrach go hiomlán:
- name: Aitheantóir inléite don duine don eochair
- acls: Liosta ceadanna (críochphointí údaraithe agus múnlaí)
- qps/qpm/tpm: Teorainneacha ráta in aghaidh an tsoicind, in aghaidh an nóiméid, agus tocain in aghaidh an nóiméid
- expireTime: Dáta éaga uathoibríoch
Is é an cleachtas a shábhálann an oiread trioblóide duit san fhadtréimhse ná expireTime a shocrú ag an am cruthaithe: éagfaidh eochair a eisiúint do phíolótach trí mhí léi féin in ionad fanacht go deo i gcomhad cumraíochta nach léann aon duine a thuilleadh.
Leanann rothlú rialta eochracha an tsláintíocht shlándála chéanna. Gineann an críochphointe tiomnaithe eochair rúnda nua agus déanann sé an ceann sean a neamhbhailíochtú:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Rabhadh: déantar an tseaneochair rúnda a neamhbhailíochtú láithreach agus go buan. Ullmhaigh an luach nua a chur in úsáid i do bhainisteoir rúnda sula rithfidh tú an t-ordú, ní ina dhiaidh sin. Cuireann trí chríochphointe inléite amháin an tacar i gcrích: liostaíonn GET /auth/teams/{teamId}/api-keys gach eochair don fhoireann, fíoraíonn GET /auth/api-keys/{apiKeyId}/propagation go bhfuil an eochair leathnaithe ar fud gach nóid, agus liostaíonn GET /auth/teams/{teamId}/models na múnlaí inrochtana lena bpraghsáil. Is é an dara ceann an ceann a chuireann tú faoi deara díreach tar éis rothlaithe, nuair a fhilltear earráidí fíordheimhnithe fós ó fheidhmchlár agus nach bhfuil tú cinnte an fabht feidhmchláir atá ann nó moill leathnaithe amháin.
Billiú a rianú agus a rialú
Baintear úsáid as críochphointe tiomnaithe chun faisnéis billithe a fháil:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Faigheann tú stair na bhfáltas le scagadh tréimhse, seo thíos do Mhárta 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Tá stádas ag gach fáltas as measc PENDING, PAID, FAILED, agus WILL_NEVER_BE_CHARGED. Tá sé i bhfad níos fearr stádas FAILED a nochtadh i do chóras monatóireachta ná teacht ar an teagmhas trí bhriseadh seirbhíse ar maidin Dé Luain.
Chun sárú buiséid a chosc, cumraigh uasteorainn mhíosúil:
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}'
Má oibríonn tú ar bhonn réamhíoctha, seiceáil an t-iarmhéid ar an mbealach céanna:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Cuimhnigh nach bhfuil creidmheasanna réamhíoctha inaisíoctha, mura n-éilíonn an dlí é. Méadaigh do chuid ceannacháin bunaithe ar an tomhaltas a breathnaíodh thar roinnt seachtainí, ní ar réamh-mheastacháin fáis optimacha.
Monatóireacht a dhéanamh ar do thomhaltas ag an ngráinneacht cheart
Ligeann an críochphointe anailíse duit úsáid a rianú le gráinneacht mhín:
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"]
}
}'
Filleann an t-iarratas seo tomhaltas laethúil tocain, briste síos de réir múnla, do mhí Mhárta. Trí timeUnit a athrú, aistríonn tú ó amharc míosúil go hamharc in aghaidh an nóiméid: is iad na luachanna féideartha ná MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR, agus MINUTE. Téann comhiomlánuithe i bhfad thar shuimeanna simplí, le SUM, AVG, MIN, MAX, P50, P90, P99, agus COUNT. Saintréithíonn céatadáin an t-ualach go héifeachtach toisc go réitíonn meáin na buaicphointí céanna a chinneann an toilleadh atá uait i ndáiríre.
Ansin glacann API Bainistíochta a áit in do shraith uirlisí. Soláthraíonn tú eochracha ó Terraform nó Pulumi díreach mar a dhéanfá le bunachar sonraí, cruthaíonn do phíblíne CI/CD eochracha sealadacha do thimpeallachtaí tástála agus scriosann sé iad ag deireadh na feidhmiúcháin, seolann scripteanna monatóireachta foláirimh sroicheann tú an t-uasteorainn caiteachais, agus taispeánann do dhea-bhordanna inmheánacha an tomhaltas gan aon duine CSV a easpórtáil gach Dé Luain.
Príomhphointí
- Déileálann API Bainistíochta ar management-api.x.ai le heochracha, billiú agus méadrachtaí
- Neamhbhailíochtaíonn rothlú eochracha an tseaneochair rúnda go buan
- Cosnaíonn teorainneacha caiteachais i gcoinne sárú buiséid
- Tairgeann anailísí úsáide gráinneacht ó nóiméad go mí
- Comhtháthaigh API Bainistíochta i do chuid uirlisí bonneagair chun an riarachán a uathoibriú