Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Költési korlátok

7. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. API-költségeid kontrollálása
  2. Jelenlegi korlátok megtekintése
  3. Korlátok beállítása
  4. Korlátstratégia környezetenként
  5. Jelenlegi terhelések megtekintése
  6. Költségmonitorozás automatizálása
  7. Korlátok dinamikus módosítása
  8. Főbb megállapítások

API-költségeid kontrollálása

A költési korlátok a pénzügyi biztonsági hálód. Ezek egy felső határt szabnak, amelyen túl az API-kéréseket a rendszer elutasítja, így megelőzve a váratlan számlákat a hónap végén. A Management API lehetővé teszi, hogy ezeket a korlátokat programozottan megtekintsd és beállítsd.

Jelenlegi korlátok megtekintése

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

A válasz tartalmazza az aktuális ciklus felső határát és az eddigi fogyasztásodat – így a különbségből kiszámolhatod a még rendelkezésre álló keretedet. Ez az egyetlen szám, ami nap mint nap számít: egy fogyasztási adatok nélküli felső határ nem árulja el, hogy a költségvetésed 10%-ánál vagy már 95%-ánál tartasz.

Korlátok beállítása

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

Mi történik a túllépés esetén?

Íme a megnyugtató rész, amit érdemes hangsúlyozni: a korlát elérése soha nem eredményez túlszámlázást. A kéréseket a rendszer elutasítja, nem számlázza ki őket a plafon felett. A kockázat így a pénzügyiről a rendelkezésre állásra tolódik át – pontosan úgy, ahogy szeretnéd, mert egy kiesést percek alatt diagnosztizálsz és megoldasz, míg egy váratlan számlát gyakran túl későn veszel észre.

Amikor a fogyasztás eléri a beállított limitet:

  • Az API-kéréseket a rendszer egy specifikus hibakóddal elutasítja
  • Az API-kulcsok aktívak maradnak, de a következtetési (inference) hívások sikertelenek lesznek
  • A korlát a következő számlázási ciklus elején alaphelyzetbe áll

Korlátstratégia környezetenként

Ha egy csapat több projekten dolgozik, a korlátnak tükröznie kell az egyes környezetek specifikus kockázatait. Fejlesztésnél a tipikus veszély egy véletlen kérésloop – például egy éjszaka futó tesztscript –, és egy alacsony, 50–100 dolláros limit ezt a hibát 10 dolláros incidenssé szelídíti 1000 dolláros meglepetés helyett. A staging környezet terheléses teszteket kezel, amelyek jogosan fogyasztanak többet: egy mérsékelt, 200–500 dolláros limit teret enged a tesztkampányoknak, miközben megtartja a biztonsági korlátot. A production környezetet azonban soha nem szabad addig fojtogatni, hogy elutasítsa a klienskéréseket: egy magasabb limit (1000 dollár és afölött, forgalomtól függően) aktív monitorozással párosul – az riasztás véd meg téged, míg a limit csupán az utolsó mentsvár.

Jelenlegi terhelések megtekintése

Hogy lásd, hol tartasz az aktuális ciklusban:

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

Ez a végpont a ciklus kezdete óta felhalmozott díjakat adja vissza. Az eltelt napok számához viszonyítva ez többet nyújt egy pillanatfelvételnél: egy előrejelzést. Ha a hónap harmadánál a költségvetés 40%-át consumesztetted el, az egészséges; ugyanez a 40% a hónap tizedénél már túllépést jelez, és még van huszonhét napod cselekedni.

Költségmonitorozás automatizálása

Küszöbérték-riasztó script

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Riasztás a limit 80%-ánál

# Limit lekérése
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)

# Jelenlegi fogyasztás lekérése
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)

# Küszöbérték ellenőrzése
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}")
        # Értesítés küldése

Integráció a monitorozó rendszerekkel

Kombináld a díjelőnézetet a monitorozó megoldásoddal (Grafana, Datadog stb.), hogy valós idejű költség-dashboardokat hozz létre:

# Aktuális összeg lekérése és elküldése a metrikarendszernek
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

Korlátok dinamikus módosítása

A limit nincs kőbe vésve a számlázási ciklusra – és ez így van jól, mert a termék élete nem követi a számviteli naptárt. Várt forgalomnövekedés, termékbevezetés vagy marketingkampány előtt ideiglenesen emeld meg a limitet: nincs is rosszabb, mint egy fizetett kampány, amely olyan szolgáltatáshoz irányítja a felhasználókat, amelynek API-ja az elért plafon miatt elutasítja a kéréseket. Ezzel szemben, ha a havi költségvetés a vártnál gyorsabban elfogy, a limit csökkentése a ciklus hátralévő részére a kontrollálatlan driftet szabályozott korláttá alakítja. A legkritikusabb eset továbbra is egy költségin incidens – egy production loop vagy észlelt visszaélés: a limit azonnali csökkentése a vészféked, ami elállítja a vérzést, amíg megtalálod az okot.

# Ideiglenes növelés egy bevezetéshez
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}'

# Normál limit visszaállítása a csúcs után
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}'

Főbb megállapítások

  • Használd a GET és POST módszereket a /v1/billing/teams/{teamId}/postpaid/spending-limits végponton a korlátok megtekintéséhez és beállításához
  • A limit túllépésekor az API-kéréseket a rendszer elutasítja (nincs túlszámlázás)
  • A díjelőnézet (invoice/preview) lehetővé teszi a fogyasztás valós idejű nyomon követését
  • Automatizáld a küszöbérték-riasztásokat a túllépések előrejelzésére
  • Igazítsd a korlátokat a környezethez (dev, staging, production)