Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Bun-URL agus an Chéad Iarratas

Ceacht 1 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. An Bainistíocht API: Plána Rialaithe Ar Leith
  2. Bun-URL
  3. Fíordheimhniú Bainistíocht API
  4. Struchtúr Críochphointe
  5. Do Chéad Iarratas Bainistíochta
  6. Príomhphointí

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.

2
URLanna Ar Leith
REST
Ailtireacht Chaighdeánach
JSON
Formáid Malartaithe
Bearer
Fíordheimhniú

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/validation duit do chumraíocht a thástáil
  • Eagraítear gach críochphointe bainistíochta timpeall ar an teamId