Költési korlátok
Ezen az oldalon
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ésPOSTmódszereket a/v1/billing/teams/{teamId}/postpaid/spending-limitsvé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)