Bun-URL agus an Chéad Iarratas
Ar an leathanach seo
An Bainistíocht API: Plána Rialaithe Ar Leith
Tá Bainistíocht API xAI ar leithligh ón API infheicthe a úsáideann tú chun leideanna a sheoladh chuig Grok. Ligeann sé duit do acmhainní a riar: eochracha API a chruthú agus a bhainistiú, billeáil a chumrú, úsáid a mhonatóiriú, agus rochtain do fhoirne a rialú. Tarlaíonn an riarachán seo go léir trí URL tiomnaithe.
Bun-URL
Ní mionsonraí cur chun feidhme é an deighilt seo: léiríonn sé difríocht bhunúsach idir an dá API. Úsáideann ceann amháin tokenaí agus rithíonn sé samhlacha; riarann an ceann eile, billeálann sé, agus deonaíonn sé ceadanna. Cinntíonn an coinneáil ar dhá fhearann agus dhá thacar eochracha nach féidir le heochair feidhmchláir goidte eochracha eile a chruthú ná d’fhaisnéis bhilleála a léamh riamh.
https://management-api.x.ai
Ná déan é a mheascadh le https://api.x.ai, arb é an URL é le haghaidh glaonna infheicthe (críochnú comhrá, leabaithe, srl.). Téann gach iarratas bainistíochta—eochracha, billeáil, anailísíocht—trí management-api.x.ai.
Fíordheimhniú Bainistíocht API
Tá an mheicníocht fíordheimhnithe mar an gcéanna—token Bearer sa cheanntásc Authorization—ach ní hionann an eochair féin. Is é seo an mhearbhall is coitianta nuair a thosaíonn tú, agus cruthaíonn sé 401 atá go hiomlán dofheicthe: ní léiríonn aon rud sa teachtaireacht earráide gur thairg tú an eochair cheart don API mícheart.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ligeann an t-iarratas bailíochtaithe seo (GET /auth/management-keys/validation) duit a fhíorú go bhfuil d’eochair bainistíochta bailí agus gníomhach. Is é an pointe iontrála is simplí é chun do chumraíocht a thástáil.
Eochair Bainistíochta vs Eochair Infheicthe
- Eochair bainistíochta: deonaíonn sé rochtain ar chríochphointí
management-api.x.ai(riarachán, billeáil, anailísíocht) - Eochair infheicthe: deonaíonn sé rochtain ar chríochphointí
api.x.ai(comhrá, leabaithe, íomhánna)
Gintear an dá chineál eochair ó chonsól xAI, ach tá a scóip éagsúil. Ní féidir le heochair infheicthe teacht ar chríochphointí bainistíochta, agus vice versa.
Struchtúr Críochphointe
Leanann críochphointí Bainistíocht API eagrú loighciúil:
/auth/teams/{teamId}/api-keys— Bainistiú eochracha API/auth/api-keys/{apiKeyId}— Oibríochtaí ar eochair ar leith/auth/teams/{teamId}/models— Samhlacha inrochtana/auth/teams/{teamId}/endpoints— Críochphointí ACL ar fáil/v1/billing/teams/{teamId}/— Billeáil agus anailísíocht
Is é do aitheantas foirne sa chonsól xAI an paraiméadar teamId, agus struchtúraíonn sé beagnach gach críochphointe. Tá a chuid eochracha, cuótaí, agus socruithe billeála ag gach foireann—rud a fhágann gurb é an t-aonad leithlisithe nádúrtha é: má scarann tú dhá thionscadal ina dhá fhoireann, scarann tú a mbuiséid agus a rochtain freisin, gan aon chumraíocht bhreise.
Do Chéad Iarratas Bainistíochta
Seo sampla iomlán chun do chumraíocht a bhailíochtú:
# Sainigh d'eochair bainistíochta
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Bailíochtaigh an eochair
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Má tá faisnéis faoi d’fhoireann agus faoi d’eochair sa fhreagra, tá do chumraíocht ag obair. Má fhaigheann tú earráid 401, fíoraigh go bhfuil eochair bainistíochta á húsáid agat (seachas eochair infheicthe).
Príomhphointí
- Úsáideann an Bainistíocht API
https://management-api.x.ai, atá ar leithligh óhttps://api.x.ai - Úsáideann an fíordheimhniú token Bearer sa cheanntásc
Authorization - Tá scóip ar leith ag eochracha bainistíochta agus eochracha infheicthe
- Ligeann an críochphointe
GET /auth/management-keys/validationduit do chumraíocht a thástáil - Eagraítear gach críochphointe bainistíochta timpeall ar an
teamId