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

Tuairiscí Ídithe Casta

Ceacht 10 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Tuairiscí ídithe a thógáil
  2. Tuairisc chomparáideach mhíosúil
  3. Brath ar ainrialtachtaí
  4. Briseadh síos de réir samhaltóir
  5. Tuairisc uathoibrithe seachtainiúil
  6. Gráinníneacht agus feidhmíocht
  7. Príomhphointí

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áideGráinníneacht mholta
Tuairisc mhíosúilMONTH
Rianú laethúilDAY
Anailís ar bhuicíHOUR nó QUARTER_HOUR
Díbhugáil fíor-amaMINUTE
Anailís mhionsonraithe ar theagmhaisSECOND

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), agus groupBy: ["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