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

API Bainistíochta: Bainistiú Eochracha agus Billithe

Ceacht 12 as 14 Nuashonraithe 28 Iúil 2026 Meánleibhéal
Ar an leathanach seo
  1. Bainistigh do chuntas gan an consól
  2. Eochracha a sholáthar agus a rothlú
  3. Billiú a rianú agus a rialú
  4. Monatóireacht a dhéanamh ar do thomhaltas ag an ngráinneacht cheart
  5. Príomhphointí

Bainistigh do chuntas gan an consól

Is comhéadan REST é API Bainistíochta xAI atá tiomnaithe do chuntas Fiontar a bhainistiú. Cé go ndéanann API Inference (api.x.ai) glaoch ar mhúnlaí, riarann API Bainistíochta (management-api.x.ai) do chuid acmhainní. D’fhéadfadh sé go mbeadh an difríocht cosúil le mioncheist. Ní hea. Aon rud a d’éileodh ar dhuine an consól gréasáin a oscailt agus cliceáil, is féidir é a uathoibriú anseo—inrianaithe, in-atáirgthe, agus in-inteangraithe leis na huirlisí a úsáideann do fhoirne cheana féin.

Eochracha a sholáthar agus a rothlú

Trí eochracha a chruthú tríd an API, is féidir leat soláthar a uathoibriú d’fheidhmchlár nó do thimpeallacht nua:

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

Sainíonn na paraiméadair san iarratas seo raon feidhme na heochrach go hiomlán:

  • name: Aitheantóir inléite don duine don eochair
  • acls: Liosta ceadanna (críochphointí údaraithe agus múnlaí)
  • qps/qpm/tpm: Teorainneacha ráta in aghaidh an tsoicind, in aghaidh an nóiméid, agus tocain in aghaidh an nóiméid
  • expireTime: Dáta éaga uathoibríoch

Is é an cleachtas a shábhálann an oiread trioblóide duit san fhadtréimhse ná expireTime a shocrú ag an am cruthaithe: éagfaidh eochair a eisiúint do phíolótach trí mhí léi féin in ionad fanacht go deo i gcomhad cumraíochta nach léann aon duine a thuilleadh.

Leanann rothlú rialta eochracha an tsláintíocht shlándála chéanna. Gineann an críochphointe tiomnaithe eochair rúnda nua agus déanann sé an ceann sean a neamhbhailíochtú:

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

Rabhadh: déantar an tseaneochair rúnda a neamhbhailíochtú láithreach agus go buan. Ullmhaigh an luach nua a chur in úsáid i do bhainisteoir rúnda sula rithfidh tú an t-ordú, ní ina dhiaidh sin. Cuireann trí chríochphointe inléite amháin an tacar i gcrích: liostaíonn GET /auth/teams/{teamId}/api-keys gach eochair don fhoireann, fíoraíonn GET /auth/api-keys/{apiKeyId}/propagation go bhfuil an eochair leathnaithe ar fud gach nóid, agus liostaíonn GET /auth/teams/{teamId}/models na múnlaí inrochtana lena bpraghsáil. Is é an dara ceann an ceann a chuireann tú faoi deara díreach tar éis rothlaithe, nuair a fhilltear earráidí fíordheimhnithe fós ó fheidhmchlár agus nach bhfuil tú cinnte an fabht feidhmchláir atá ann nó moill leathnaithe amháin.

Billiú a rianú agus a rialú

Baintear úsáid as críochphointe tiomnaithe chun faisnéis billithe a fháil:

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

Faigheann tú stair na bhfáltas le scagadh tréimhse, seo thíos do Mhárta 2026:

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

Tá stádas ag gach fáltas as measc PENDING, PAID, FAILED, agus WILL_NEVER_BE_CHARGED. Tá sé i bhfad níos fearr stádas FAILED a nochtadh i do chóras monatóireachta ná teacht ar an teagmhas trí bhriseadh seirbhíse ar maidin Dé Luain.

Chun sárú buiséid a chosc, cumraigh uasteorainn mhíosúil:

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

Má oibríonn tú ar bhonn réamhíoctha, seiceáil an t-iarmhéid ar an mbealach céanna:

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

Cuimhnigh nach bhfuil creidmheasanna réamhíoctha inaisíoctha, mura n-éilíonn an dlí é. Méadaigh do chuid ceannacháin bunaithe ar an tomhaltas a breathnaíodh thar roinnt seachtainí, ní ar réamh-mheastacháin fáis optimacha.

Monatóireacht a dhéanamh ar do thomhaltas ag an ngráinneacht cheart

Ligeann an críochphointe anailíse duit úsáid a rianú le gráinneacht mhín:

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

Filleann an t-iarratas seo tomhaltas laethúil tocain, briste síos de réir múnla, do mhí Mhárta. Trí timeUnit a athrú, aistríonn tú ó amharc míosúil go hamharc in aghaidh an nóiméid: is iad na luachanna féideartha ná MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR, agus MINUTE. Téann comhiomlánuithe i bhfad thar shuimeanna simplí, le SUM, AVG, MIN, MAX, P50, P90, P99, agus COUNT. Saintréithíonn céatadáin an t-ualach go héifeachtach toisc go réitíonn meáin na buaicphointí céanna a chinneann an toilleadh atá uait i ndáiríre.

Ansin glacann API Bainistíochta a áit in do shraith uirlisí. Soláthraíonn tú eochracha ó Terraform nó Pulumi díreach mar a dhéanfá le bunachar sonraí, cruthaíonn do phíblíne CI/CD eochracha sealadacha do thimpeallachtaí tástála agus scriosann sé iad ag deireadh na feidhmiúcháin, seolann scripteanna monatóireachta foláirimh sroicheann tú an t-uasteorainn caiteachais, agus taispeánann do dhea-bhordanna inmheánacha an tomhaltas gan aon duine CSV a easpórtáil gach Dé Luain.

Príomhphointí

  • Déileálann API Bainistíochta ar management-api.x.ai le heochracha, billiú agus méadrachtaí
  • Neamhbhailíochtaíonn rothlú eochracha an tseaneochair rúnda go buan
  • Cosnaíonn teorainneacha caiteachais i gcoinne sárú buiséid
  • Tairgeann anailísí úsáide gráinneacht ó nóiméad go mí
  • Comhtháthaigh API Bainistíochta i do chuid uirlisí bonneagair chun an riarachán a uathoibriú