Teorainneacha Caiteachais
Ar an leathanach seo
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
GETagusPOSTar/v1/billing/teams/{teamId}/postpaid/spending-limitschun 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)