Tuairiscí Ídithe Casta
Ar an leathanach seo
Tuairiscí ídithe a thógáil
Níl aon mhaith i sonraí ídithe nach bhfuil á bhreathnú ag duine ar bith. Níl tuairisc úsáideach ach amháin má fhreagraíonn sí ceist a chuireann tú i ndáiríre, agus níl ach trí cinn ann: an bhfuil méadú ann, an dtarla rud éigin mínormálta, agus cá bhfuil an t-airgead ag dul.
Pléifidh an trí chuid seo a leanas na ceisteanna sin san ord sin. Cruthaíonn gach ceann acu uimhir is féidir leat gníomhú uirthi—ní hamháin cairt eile.
Tuairisc chomparáideach mhíosúil
Níl ciall le híditeacht ach amháin i gcomparáid. Ní maith ná olc é $400 i mí i dtéarmaí absalóideacha: is é an rud a chomhaireamh ná an leanann sé mí $200 nó mí $600. Cuir athruithe i gcomhthéacs i gcónaí leis an eolas atá agat faoi ghníomhaíocht—táthar ag súil le méadú 40% tar éis gné a sheoladh, ach éilíonn an méadú céanna gan aon rud nua duit an chuid seo a leanas a oscailt.
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def get_monthly_usage(year, month):
"""Retrieves total consumption for a given month."""
next_month = month + 1 if month < 12 else 1
next_year = year if month < 12 else year + 1
response = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/usage",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={
"analyticsRequest": {
"timeRange": {
"startTime": f"{year}-{month:02d}-01 00:00:00",
"endTime": f"{next_year}-{next_month:02d}-01 00:00:00",
"timezone": "Europe/Paris"
},
"timeUnit": "MONTH",
"values": [
{"name": "tokens", "aggregation": "SUM"},
{"name": "requests", "aggregation": "COUNT"}
],
"groupBy": ["model"]
}
}
)
return response.json()
# Compare March and April 2026
march = get_monthly_usage(2026, 3)
april = get_monthly_usage(2026, 4)
print("=== Comparative Report March vs April 2026 ===")
print(json.dumps(march, indent=2))
print(json.dumps(april, indent=2))
Brath ar ainrialtachtaí
Sainíonn an diall caighdeánach “mínormálta” anseo gan gá le tairseach treallach a shocrú: tá lá atá níos faide ná dhá dhiall caighdeánach ó do mheán lasmuigh den ghnáthphatrún, beag beann ar do mhéid. Seo an modh a oiriúnaíonn go huathoibríoch de réir mar a fhásann do ghníomhaíocht, áit a n-éiríonn tairseach dollar seanbhunaithe an mhí dár gcionn.
import requests
import statistics
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Retrieve daily consumption for the month
response = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/usage",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "Europe/Paris"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}]
}
}
)
data = response.json()
daily_values = [point.get("value", 0) for point in data.get("dataPoints", [])]
if daily_values:
mean = statistics.mean(daily_values)
stdev = statistics.stdev(daily_values) if len(daily_values) > 1 else 0
threshold = mean + 2 * stdev # Threshold at 2 standard deviations
for i, val in enumerate(daily_values):
if val > threshold:
print(f"Day {i+1}: {val} tokens (anomaly, threshold = {threshold:.0f})")
Briseadh síos de réir samhaltóir
Seo an tuairisc a thugann an toradh is mó, toisc go dtreoraíonn sí gníomhaíocht chruinn. Ní insíonn costas iomlán duit cad le déanamh; déanann briseadh síos de réir samhaltóir é—nochtann sé tascanna simplí atá beartaithe don tsamhaltóir is costasaí, arb iad na coigiltí is fusa a bhaint amach ar bhille API.
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
-H "Authorization: Bearer $MANAGEMENT_API_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": "MONTH",
"values": [
{"name": "tokens", "aggregation": "SUM"},
{"name": "cost", "aggregation": "SUM"}
],
"groupBy": ["model"]
}
}'
Is féidir leis an anailís seo deiseanna feabhsaithe a nochtadh: má úsáideann cuid mhór d’iarratais grok-4.20-0309-reasoning do thascanna simplí, d’fhéadfadh aistriú go grok-4.3 costais a laghdú go suntasach.
Tuairisc uathoibrithe seachtainiúil
Athraíonn seachadadh uathoibrithe nádúr an chleachtais: ní dhéantar comhairle a thabhairt ar thuairisc a chaithfidh tú a fháil ach tar éis na teagmhaise; léitear tuairisc a thagann roimh ré. Is é an seachtain an ráta ceart d’íditeacht API—minic go leor chun claonadh a bhrath sula dtagann an bille, ach scartha go leor ionas go gcoimeádann tú á hoscailt.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Previous week
end = datetime.now().replace(hour=0, minute=0, second=0, microsecond=0)
start = end - timedelta(days=7)
response = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/usage",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={
"analyticsRequest": {
"timeRange": {
"startTime": start.strftime("%Y-%m-%d %H:%M:%S"),
"endTime": end.strftime("%Y-%m-%d %H:%M:%S"),
"timezone": "Europe/Paris"
},
"timeUnit": "DAY",
"values": [
{"name": "tokens", "aggregation": "SUM"},
{"name": "requests", "aggregation": "COUNT"}
],
"groupBy": ["model"]
}
}
)
report = response.json()
print(f"=== Weekly Report {start.date()} → {end.date()} ===")
# Format report for email/Slack
# ... send via your preferred notification tool
Gráinníneacht agus feidhmíocht
An ghráinníneacht cheart a roghnú
| Cás úsáide | Gráinníneacht mholta |
|---|---|
| Tuairisc mhíosúil | MONTH |
| Rianú laethúil | DAY |
| Anailís ar bhuicí | HOUR nó QUARTER_HOUR |
| Díbhugáil fíor-ama | MINUTE |
| Anailís mhionsonraithe ar theagmhais | SECOND |
Dá mhionfheictear an ghráinníneacht, is ea is mó an méid sonraí a thugtar ar ais: thar mhí, cruthaíonn gráinníneacht SECOND milliúin pointí, le ham freagartha agus ídiú cuimhne comhfhreagrach. Is é an riail ghinearálta ná gráinníneacht a roghnú bunaithe ar fhad an ruda atá á lorg agat—tá buic cúpla nóiméad dofheicthe ag gráinníneacht MONTH, agus báite i dtorann ag gráinníneacht SECOND.
Príomhphointí
- Comhcheangail
SUM(iomlán),COUNT(líon), agusgroupBy: ["model"]le haghaidh tuairiscí iomlána - Aithníonn brath ar ainrialtachtaí le diall caighdeánach laethanta ró-ídithe
- Nochtann briseadh síos de réir samhaltóir deiseanna chun costais a bharrfheabhsú
- Oiriúnaigh an ghráinníneacht ama don chás úsáide: MONTH do thuairiscí, HOUR do dhíbheagú
- Uathoibrigh tuairiscí seachtainiúla chun súil a choinneáil ar an íditeacht