URL Bażi u l-Ewwel Talba
F'din il-paġna
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.
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 minnhttps://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/validationjippermettilek tittestja l-konfigurazzjoni tiegħek - L-endpoints kollha tal-ġestjoni huma organizzati madwar il-
teamId