Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Ograničenja troškova

Lekcija 7 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Kontroliraj troškove API-ja
  2. Pregled trenutnih ograničenja
  3. Postavljanje ograničenja
  4. Pregled trenutnih troškova
  5. Automatiziraj nadzor troškova
  6. Dinamičko prilagođavanje ograničenja
  7. Ključne točke

Kontroliraj troškove API-ja

Ograničenja troškova tvoja su financijska sigurnosna mreža. Ona postavljaju strop iznad kojeg se API zahtjevi odbijaju, čime se sprječavaju neočekivani troškovi na kraju mjeseca. Management API omogućuje ti programski pregled i postavljanje tih ograničenja.

Pregled trenutnih ograničenja

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

Odgovor prikazuje trenutni strop ciklusa i tvoju trenutnu potrošnju – dakle, razlikom, tvoju preostalu marginu. To je jedini broj koji je bitan u svakodnevnom radu: strop bez podataka o potrošnji ne govori ti nalaziš li se na 10 % ili 95 % svog proračuna.

Postavljanje ograničenja

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

Ponašanje pri premašivanju

Evo ohrabrujućeg dijela, i vrijedi to eksplicitno naglasiti: dosezanje ograničenja nikada ne rezultira prekomjernom naplatom. Zahtjevi se odbijaju, a ne naplaćuju iznad stropa. Rizik se pomiče s financijskog na dostupnost – što je točno ono što želiš, jer se kvar dijagnosticira i popravi u nekoliko minuta, dok se neočekivani račun otkrije prekasno.

Kada potrošnja dosegne postavljeno ograničenje:

  • API zahtjevi se odbijaju s određenom šifrom pogreške
  • API ključevi ostaju aktivni, ali pozivi za inferenciju ne uspijevaju
  • Ograničenje se resetira na početku sljedećeg obračunskog ciklusa

Strategija ograničenja po okruženju

Za tim s više projekata, ograničenje treba odražavati rizik specifičan za svako okruženje. U razvoju je tipična opasnost slučajna petlja zahtjeva – testna skripta koja radi cijelu noć – a nisko ograničenje od 50 do 100 USD tu grešku pretvara u incident od 10 USD, a ne u iznenađenje od 1000 USD. Staging okruženje rukuje testovima opterećenja, koji legitimno troše više: umjereno ograničenje od 200 do 500 USD ostavlja prostora za testne kampanje, a zadržava zaštitnu ogradu. Produkcija, međutim, nikada ne smije biti ograničena do točke odbijanja zahtjeva klijenata: više ograničenje (1000 USD i više, ovisno o prometu) dolazi s aktivnim nadzorom – upozorenje te štiti, dok je ograničenje samo sigurnosna mreža za krajnji slučaj.

Pregled trenutnih troškova

Da vidiš gdje se nalaziš u trenutnom ciklusu:

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

Ova krajnja točka vraća troškove akumulirane od početka ciklusa. U usporedbi s brojem proteklih dana, daje ti više od trenutnog stanja: projekciju. Potrošnja 40 % proračuna u prvoj trećini mjeseca je zdrava; istih 40 % u prvoj desetini mjeseca signalizira prekoračenje, a još imaš dvadeset sedam dana za djelovanje.

Automatiziraj nadzor troškova

Skripta za upozorenje o pragu

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Upozori na 80 % ograničenja

# Dohvati ograničenje
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)

# Dohvati trenutnu potrošnju
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)

# Provjeri prag
if monthly_limit > 0:
    ratio = current_spend / monthly_limit
    if ratio >= ALERT_THRESHOLD:
        print(f"UPOZORENJE: dosegnuto {ratio*100:.1f}% ograničenja")
        print(f"  Potrošnja: ${current_spend:.2f} / ${monthly_limit:.2f}")
        # Pošalji obavijest

Integracija s nadzorom

Kombiniraj pregled troškova sa svojim rješenjem za nadzor (Grafana, Datadog itd.) kako bi stvorio nadzorne ploče troškova u stvarnom vremenu:

# Dohvati trenutni iznos za slanje u svoj sustav metrika
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

Dinamičko prilagođavanje ograničenja

Ograničenje nije uklesano u kamen za obračunski ciklus – i to je dobra stvar, jer životni vijek proizvoda ne prati računovodstveni kalendar. Prije očekivanog skoka prometa, lansiranja proizvoda ili marketinške kampanje, privremeno povećaj ograničenje: nema ništa gore od plaćene kampanje koja šalje korisnike na uslugu čiji API odbija zahtjeve zbog dosegnutog stropa. Suprotno tome, ako je mjesečni proračun već potrošen brže nego što se očekivalo, snižavanje ograničenja za ostatak ciklusa pretvara odstupanje u kontrolirano ograničenje. Najkritičniji slučaj ostaje incident troškova – petlja u produkciji, otkrivena zlouporaba: trenutno snižavanje ograničenja tvoj je gumb za hitno zaustavljanje, onaj koji zaustavlja krvarenje dok pronalaziš uzrok.

# Privremeno povećaj za lansiranje
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}'

# Resetiraj normalno ograničenje nakon skoka
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}'

Ključne točke

  • GET i POST na /v1/billing/teams/{teamId}/postpaid/spending-limits za pregled i postavljanje ograničenja
  • Kada se ograničenje premaši, API zahtjevi se odbijaju (nema prekomjerne naplate)
  • Pregled troškova (invoice/preview) omogućuje praćenje potrošnje u stvarnom vremenu
  • Automatiziraj upozorenja o pragovima kako bi anticipirao prekoračenja
  • Prilagodi ograničenja prema okruženju (razvoj, staging, produkcija)