Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

URL Bażi u l-Ewwel Talba

Lezzjoni 1 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-API tal-Ġestjoni: Pjan ta’ Kontroll Separat
  2. URL Bażi
  3. Awtentikazzjoni tal-API tal-Ġestjoni
  4. Struttura tal-Endpoint
  5. L-Ewwel Talba tal-Ġestjoni Tiegħek
  6. Punti Ewlenin

L-API tal-Ġestjoni: Pjan ta’ Kontroll Separat

L-API tal-Ġestjoni (Management API) ta’ xAI hija distinta mill-API tal-inferenza li tuża biex tibgħat prompts lil Grok. Din tippermettilek tamministra r-riżorsi tiegħek: toħloq u timmaniġġja ċ-ċwievet tal-API, tikkonfigura l-fatturazzjoni, timmonitorja l-użu, u tikkontrolla l-aċċess tat-tim tiegħek. Din l-amministrazzjoni kollha sseħħ permezz ta’ URL dedikat.

URL Bażi

Din is-separazzjoni mhix sempliċiment dettall ta’ implimentazzjoni: tirrifletti differenza fundamentali bejn iż-żewġ API. Waħda tikkonsma tokens u tħaddem mudelli; l-oħra tamministra, tiffattura u tagħti permessi. Li żżommuhom fuq żewġ domini u żewġ settijiet ta’ ċwievet jiggarantixxi li ċavetta tal-applikazzjoni misruqa qatt ma tkun tista’ toħloq ċwievet oħra jew taqra l-informazzjoni tal-fatturazzjoni tiegħek.

https://management-api.x.ai

Tħallitx din ma’ https://api.x.ai, li hija l-URL għas-sejħiet tal-inferenza (tlestija ta’ chat, embeddings, eċċ.). It-talbiet kollha tal-ġestjoni—ċwievet, fatturazzjoni, analitika—jgħaddu minn management-api.x.ai.

2
URLs Distinti
REST
Arkitettura Standard
JSON
Format ta' Skambju
Bearer
Awtentikazzjoni

Awtentikazzjoni tal-API tal-Ġestjoni

Il-mekkaniżmu ta’ awtentikazzjoni huwa identiku—token Bearer fl-intestatura Authorization—iċ-ċavetta nnifisha mhix. Din hija l-konfużjoni l-aktar komuni meta tibda, u tipproduċi 401 kompletament opaku: xejn fil-messaġġ ta’ żball ma jindika li sempliċiment ippreżentajt iċ-ċavetta t-tajba lill-API l-żbaljata.

curl https://management-api.x.ai/auth/management-keys/validation \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Din it-talba ta’ validazzjoni (GET /auth/management-keys/validation) tippermettilek tivverifika li ċ-ċavetta tal-ġestjoni tiegħek hija valida u attiva. Hija l-punt tad-dħul l-aktar sempliċi biex tittestja l-konfigurazzjoni tiegħek.

Ċavetta tal-Ġestjoni vs Ċavetta tal-Inferenza

  • Ċavetta tal-ġestjoni: tagħti aċċess għall-endpoints ta’ management-api.x.ai (amministrazzjoni, fatturazzjoni, analitika)
  • Ċavetta tal-inferenza: tagħti aċċess għall-endpoints ta’ api.x.ai (chat, embeddings, immaġni)

Iż-żewġ tipi ta’ ċwievet jiġu ġġenerati mill-konsoll ta’ xAI, iżda l-ambiti (scopes) tagħhom ivarjaw. Ċavetta tal-inferenza ma tistax taċċessa endpoints tal-ġestjoni, u viċi versa.

Struttura tal-Endpoint

L-endpoints tal-API tal-Ġestjoni jsegwu organizzazzjoni loġika:

  • /auth/teams/{teamId}/api-keys — Ġestjoni taċ-ċwievet tal-API
  • /auth/api-keys/{apiKeyId} — Operazzjonijiet fuq ċavetta speċifika
  • /auth/teams/{teamId}/models — Mudelli aċċessibbli
  • /auth/teams/{teamId}/endpoints — Endpoints ACL disponibbli
  • /v1/billing/teams/{teamId}/ — Fatturazzjoni u analitika

Il-parametru teamId huwa l-identifikatur tat-tim tiegħek fil-konsoll ta’ xAI, u jistruttura kważi l-endpoints kollha. Kull tim għandu ċ-ċwievet, il-kwoti u l-konfigurazzjonijiet tal-fatturazzjoni tiegħu stess—li jagħmluha l-unità naturali ta’ iżolament: is-separazzjoni ta’ żewġ proġetti f’żewġ timijiet tissepara wkoll il-baġits u l-aċċess tagħhom, mingħajr l-ebda konfigurazzjoni addizzjonali.

L-Ewwel Talba tal-Ġestjoni Tiegħek

Hawnhekk hemm eżempju sħiħ biex tivvalida l-konfigurazzjoni tiegħek:

# Iddefinixxi ċ-ċavetta tal-ġestjoni tiegħek
export MANAGEMENT_API_KEY="xai-mgmt-..."

# Ivvvalida ċ-ċavetta
curl -s https://management-api.x.ai/auth/management-keys/validation \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Jekk ir-risposta fiha l-informazzjoni tat-tim u taċ-ċavetta tiegħek, il-konfigurazzjoni tiegħek qed taħdem. Jekk tikseb żball 401, ivverifika li qed tuża ċavetta tal-ġestjoni (mhux ċavetta tal-inferenza).

Punti Ewlenin

  • L-API tal-Ġestjoni tuża https://management-api.x.ai, distint minn https://api.x.ai
  • L-awtentikazzjoni tuża token Bearer fl-intestatura Authorization
  • Iċ-ċwievet tal-ġestjoni u ċ-ċwievet tal-inferenza għandhom ambiti separati
  • L-endpoint GET /auth/management-keys/validation jippermettilek tittestja l-konfigurazzjoni tiegħek
  • L-endpoints kollha tal-ġestjoni huma organizzati madwar il-teamId