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

Teorainneacha Caiteachais

Ceacht 7 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Rialú do Chostais API
  2. Féach ar Theorainneacha Reatha
  3. Socraigh Teorainneacha
  4. Féach ar Mhuirir Reatha
  5. Uathoibrigh Monatóireacht Costais
  6. Coigeartaigh Teorainneacha go Dinimiciúil
  7. Príomhphointí

Rialú do Chostais API

Is éard atá i dteorainneacha caiteachais ná do líon sábháilteachta airgeadais. Socraíonn siad uasteorainn nach féidir a shárú; diúltaítear d’iarratais API thar an bpointe sin, rud a chuireann cosc ar mhuirir gan choinne ag deireadh na míosa. Ligeann an Bainistíocht API duit na teorainneacha seo a fheiceáil agus a shocrú go cláraithe.

Féach ar Theorainneacha Reatha

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Taispeánann an freagra an t-uasteorainn don timthriall reatha agus do thomhaltas faoi láthair—mar sin, tríd an difríocht a ríomh, faigheann tú do mhargadh atá fágtha. Seo an t-aon uimhir a bhfuil tábhacht léi ó lá go lá: ní insíonn uasteorainn gan sonraí tomhaltais duit an bhfuil tú ag 10% nó ag 95% de do bhuiséad.

Socraigh Teorainneacha

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "monthlyLimit": 500.00
  }'

Iompar nuair a Sháraítear an Teorainn

Seo an chuid atá suaimhneach, agus fiú é a rá go sonrach: ní chruthaíonn sárú na teorann riamh muirearú breise. Diúltaítear d’iarratais, ní dhéantar iad a bhilliú thar an gcap. Aistríonn an riosca ó bheith airgeadais go bheith ar fáilteacht—agus is é sin díreach an rud atá uait, toisc go ndéantar briseadh a dhiagnóisiú agus a dheisiú i gceann cúpla nóiméad, ach faightear amach faoi bhille gan choinne ró-dhéanach.

Nuair a shroicheann an tomhaltas an teorainn shocraithe:

  • Diúltaítear d’iarratais API le cód earráide sonrach
  • Fanann eochracha API gníomhach ach teipeann ar ghlaonna infearence
  • Athshocraítear an teorainn ag tús an chéad timthrialla billeála eile

Straitéis Teorann de réir Timpeallachta

Do fhoireann a bhfuil tionscadail iolracha aici, ba chóir go léireodh an teorainn an riosca atá sonrach do gach timpeallacht. I bhforbairt, is é an baol tipiciúil ná lúb iarratais thimpisteach—script tástála ag rith ar feadh na hoíche—agus déanann teorainn íseal $50 go $100 tionóisc $10 den earráid sin seachas iontas $1,000. Déileálann an timpeallacht stáitsithe le tástálacha ualaigh, a úsáideann níos mó go dleathach: fágann teorainn mheasartha $200 go $500 spás do fheachtais tástála agus coimeádann sí cosantóir ar bun. Ach, níor chóir an timpeallacht táirgeachta a bhrú go dtí an pointe go ndiúltaítear d’iarratais cliant: tagann teorainn níos airde ($1,000 agus níos mó, ag brath ar do thrácht) le monatóireacht ghníomhach—cosnaíonn an foláireamh thú, agus nílimid sa teorainn ach mar líon sábháilteachta deireanach.

Féach ar Mhuirir Reatha

Chun a fheiceáil cá bhfuil tú sa timthriall reatha:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Filleann an críochphointe seo muirir a carnadh ó thús an timthrialla. I gcomparáid leis an líon laethanta atá caite, tugann sé níos mó ná grianghraf duit: réamh-mheastachán. Is sláintiúil 40% den bhuiséad a úsáid agus tríú cuid den mhí caite; léiríonn an 40% céanna ag deichiú cuid den mhí sárú, agus tá fiche seacht lá fágtha agat fós le gníomhú.

Uathoibrigh Monatóireacht Costais

Script Foláirimh Tairsí

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Alert at 80% of limit

# Get the limit
limits_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/spending-limits",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
monthly_limit = limits_resp.json().get("monthlyLimit", 0)

# Get current consumption
preview_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/invoice/preview",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_spend = preview_resp.json().get("totalAmount", 0)

# Check threshold
if monthly_limit > 0:
    ratio = current_spend / monthly_limit
    if ratio >= ALERT_THRESHOLD:
        print(f"ALERT: {ratio*100:.1f}% of limit reached")
        print(f"  Spend: ${current_spend:.2f} / ${monthly_limit:.2f}")
        # Send notification

Comhtháthú le Monatóireacht

Comhcheangail an réamhamharc muirear le do réiteach monatóireachta (Grafana, Datadog, srl.) chun deascanna costais fíor-ama a chruthú:

# Get current amount to send to your metrics system
CURRENT_SPEND=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('totalAmount', 0))")

echo "xai.billing.current_spend:$CURRENT_SPEND|g" | nc -u -w1 localhost 8125

Coigeartaigh Teorainneacha go Dinimiciúil

Níl an teorainn socraithe i gclóchloch don timthriall billeála—agus is maith an scéal é sin, mar ní leanann saol an táirge féilire na cuntaíochta. Roimh buaic thráchta a bhfuiltear ag súil leis, seoladh táirge, nó feachtas margaíochta, méadaigh an teorainn go sealadach: níl aon rud níos measa ná feachtas íoctha a sheolann úsáideoirí chuig seirbhís a dhiúltaíonn d’iarratais API mar gheall ar uasteorainn a sroicheadh. Os a choinne sin, má chaitear buiséad na míosa níos tapúla ná mar a bhíothas ag súil leis, laghdaíonn an teorainn don chuid eile den timthriall an claonadh ina srian rialaithe. Is é an cás is criticiúla fós ná tionóisc costais—lúb sa táirgeadh, mí-úsáid a braiteadh: is é an teorainn a laghdú láithreach do chnaipe éigeandála, an ceann a stopann an fuiliú agus tú ag lorg na cúise.

# Temporarily increase for a launch
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 2000.00}'

# Reset normal limit after the spike
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 500.00}'

Príomhphointí

  • Úsáid GET agus POST ar /v1/billing/teams/{teamId}/postpaid/spending-limits chun teorainneacha a fheiceáil agus a shocrú
  • Nuair a sháraítear an teorainn, diúltaítear d’iarratais API (gan muirearú breise)
  • Ligeann an réamhamharc muirear (invoice/preview) duit tomhaltas a rianú i bhfíor-am
  • Uathoibrigh foláirimh tairsí chun sáruithe a réamh-mheas
  • Oiriúnaigh teorainneacha de réir timpeallachta (forbairt, stáitsiú, táirgeadh)