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

API tal-Ġestjoni: Ġestjoni taċ-Ċwievet u tal-Fatturazzjoni

Lezzjoni 12 / 14 Aġġornat 28 ta’ Lulju 2026 Livell Medju
F'din il-paġna
  1. Immaniġġja l-kont tiegħek mingħajr il-console
  2. Ipprovdi u ddur biċ-ċwievet
  3. Segwi u kkontrolla l-fatturazzjoni
  4. Immonitorja l-konsum tiegħek bil-granularità t-tajba
  5. Punti Ewlenin

Immaniġġja l-kont tiegħek mingħajr il-console

L-API tal-Ġestjoni ta’ xAI hija interfaċċa REST iddedikata għall-ġestjoni tal-kont Enterprise tiegħek. Filwaqt li l-API tal-Inferenza (api.x.ai) tsejjaħ il-mudelli, l-API tal-Ġestjoni (management-api.x.ai) tamministra r-riżorsi tiegħek. Id-distinzjoni tista’ tidher żgħira. Mhix. Kull ħaġa li kieku tkun teħtieġ li xi ħadd jiftaħ il-console tal-web u jikklikkja ssir awtomatizzabbli hawnhekk—traċċabbli, riproduċibbli, u integrabbli mal-għodod li t-timijiet tiegħek diġà jużaw.

Ipprovdi u ddur biċ-ċwievet

Il-ħolqien ta’ ċwievet permezz tal-API jħallik tawtomatizza l-provvista għal applikazzjoni jew ambjent ġdid:

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"
  }'

Il-parametri f’din it-talba jiddefinixxu bis-sħiħ l-ambitu taċ-ċavetta:

  • name: Identifikatur li jista’ jaqrah il-bniedem għaċ-ċavetta
  • acls: Lista ta’ permessi (endpoints u mudelli awtorizzati)
  • qps/qpm/tpm: Limiti tar-rata kull sekonda, kull minuta, u tokens kull minuta
  • expireTime: Data ta’ skadenza awtomatika

Li tissettja expireTime fil-ħolqien hija l-abitudni li tiffrankalek l-akbar problemi fit-tul: ċavetta maħruġa għal pilot ta’ tliet xhur tiskadi waħedha minflok ma tibqa’ tgħix għal dejjem f’fajl ta’ konfigurazzjoni li ħadd ma jaqra aktar.

Id-dawran regolari taċ-ċwievet isegwi l-istess iġjene tas-sigurtà. L-endpoint iddedikat jiġġenera ċavetta sigrieta ġdida u jinvalida dik antika:

curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Twissija: iċ-ċavetta sigrieta antika tiġi invalidata immedjatament u b’mod permanenti. Ipprepara biex tiddispjega l-valur il-ġdid fil-ġestur tas-sigrieti tiegħek qabel ma tmexxi l-kmand, qatt wara. Tliet endpoints ta’ qari biss jikkompletaw is-sett: GET /auth/teams/{teamId}/api-keys jelenka l-ċwievet kollha għat-tim, GET /auth/api-keys/{apiKeyId}/propagation jivverifika li ċ-ċavetta ġiet propagata fuq in-nodi kollha, u GET /auth/teams/{teamId}/models jelenka l-mudelli aċċessibbli bil-prezzijiet tagħhom. It-tieni wieħed huwa dak li tikkonsulta eżatt wara dawran, meta applikazzjoni għadha tirritorna żbalji ta’ awtentikazzjoni u mhux ċert jekk hix bug fl-applikazzjoni jew sempliċiment dewmien fil-propagazzjoni.

Segwi u kkontrolla l-fatturazzjoni

L-irkupru ta’ informazzjoni dwar il-fatturazzjoni juża endpoint iddedikat:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Tirkupra l-istorja tal-fatturi b’filtru skont il-perjodu, hawnhekk għal Marzu 2026:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Kull fattura ġġorr status wieħed minn PENDING, PAID, FAILED, u WILL_NEVER_BE_CHARGED. Li twassal status FAILED fil-monitoraġġ tiegħek huwa ferm aħjar milli titgħallem dwar l-inċident permezz ta’ interruzzjoni tas-servizz f’għodwa ta’ Tnejn.

Biex tipprevjeni li taqbeż il-baġit, ikkonfigura limitu mensili:

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}'

Jekk topera fuq bażi mħallsa minn qabel (prepaid), iċċekkja l-bilanċ bl-istess mod:

# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Ftakar li l-krediti mħallsa minn qabel huma mhux rimborsabbli, ħlief jekk meħtieġ legalment. Iddimensjona x-xirjiet tiegħek ibbażat fuq il-konsum osservat fuq diversi ġimgħat, mhux fuq projezzjonijiet ta’ tkabbir ottimistiċi.

Immonitorja l-konsum tiegħek bil-granularità t-tajba

L-endpoint tal-analitika jħallik issegwi l-użu b’granularità fina:

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"]
    }
  }'

Din it-talba tirritorna l-konsum ta’ tokens kuljum, maqsum skont il-mudell, għal Marzu. Billi tbiddel timeUnit, taqleb minn veduta mensili għal veduta kull minuta: il-valuri possibbli huma MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR, u MINUTE. L-aggregazzjonijiet imorru ferm lil hinn mit-totali sempliċi, b’SUM, AVG, MIN, MAX, P50, P90, P99, u COUNT. Il-perċentili jikkaratterizzaw it-tagħbija b’mod effettiv għax il-medji jillixxaw eżattament dawk il-quċċati li jiddeterminaw il-kapaċità li tassew teħtieġ.

L-API tal-Ġestjoni mbagħad tieħu postha fil-katina tal-għodod tiegħek. Tipprovdi ċwievet minn Terraform jew Pulumi eżatt bħal database, il-pipeline CI/CD tiegħek joħloq ċwievet efimeri għal ambjenti ta’ test imbagħad iħassarhom fit-tmiem tal-eżekuzzjoni, l-iskripts tal-monitoraġġ jallertaw qabel ma jintlaħaq il-limitu tan-nefqa, u d-dashboards interni tiegħek juru l-konsum mingħajr ma bniedem jesporta CSV kull Tnejn.

Punti Ewlenin

  • L-API tal-Ġestjoni fuq management-api.x.ai tittratta ċ-ċwievet, il-fatturazzjoni u l-metriċi
  • Id-dawran taċ-ċavetta jinvalida b’mod permanenti ċ-ċavetta sigrieta antika
  • Il-limiti tan-nefqa jipproteġu kontra li taqbeż il-baġit
  • L-analitika tal-użu toffri granularità mill-minuta sax-xahar
  • Integra l-API tal-Ġestjoni fl-għodod tal-infrastruttura tiegħek biex tawtomatizza l-amministrazzjoni