Limite de cheltuieli
Pe această pagină
Controlați-vă costurile API
Limitele de cheltuieli reprezintă plasa dumneavoastră de siguranță financiară. Acestea stabilesc un plafon dincolo de care cererile API sunt refuzate, prevenind taxele neașteptate la sfârșitul lunii. API-ul de Management vă permite să vizualizați și să setați aceste limite programatic.
Vizualizarea limitelor curente
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Răspunsul afișează plafonul ciclului curent și consumul dumneavoastră actual — astfel, prin diferență, marja rămasă. Acesta este singurul număr care contează în activitatea zilnică: un plafon fără date despre consum nu vă spune dacă ați atins 10% sau 95% din buget.
Setarea limitelor
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
}'
Comportament la depășirea limitei
Iată partea liniștitoare, care merită enunțată explicit: atingerea limitei nu duce niciodată la suprafacturare. Cererile sunt refuzate, nu facturate dincolo de plafon. Riscul se mută de la cel financiar la cel de disponibilitate — exact ceea ce doriți, deoarece o pană este diagnosticată și remediată în câteva minute, în timp ce o factură neașteptată este descoperită prea târziu.
Atunci când consumul atinge limita setată:
- Cererile API sunt refuzate cu un cod de eroare specific
- Cheile API rămân active, dar apelurile de inferență eșuează
- Limita se resetează la începutul următorului ciclu de facturare
Strategia de limitare în funcție de mediu
Pentru o echipă cu multiple proiecte, limita ar trebui să reflecte riscul specific fiecărui mediu. În dezvoltare, pericolul tipic este o buclă accidentală de cereri — un script de test care rulează toată noaptea — iar o limită scăzută de 50 până la 100 USD transformă acea eroare într-un incident de 10 USD, nu într-o surpriză de 1.000 USD. Staging gestionează teste de sarcină, care consumă legitim mai mult: o limită moderată de 200 până la 500 USD lasă loc campaniilor de testare, menținând totodată o barieră de protecție. Producția, însă, nu ar trebui niciodată să fie limitată până la punctul de a refuza cererile clienților: o limită mai mare (1.000 USD și peste, în funcție de traficul dumneavoastră) vine cu monitorizare activă — alerta vă protejează, în timp ce limita este doar plasa de siguranță de ultimă instanță.
Vizualizarea taxelor curente
Pentru a vedea unde vă situați în ciclul curent:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Acest endpoint returnează taxele acumulate de la începutul ciclului. Comparat cu numărul de zile scurse, oferă mai mult decât o simplă imagine instantanee: o proiecție. Consumul a 40% din buget la o treime din lună este sănătos; același 40% la o zecime din lună semnalează o depășire, iar dumneavoastră mai aveți încă douăzeci și șapte de zile pentru a acționa.
Automatizarea monitorizării costurilor
Script de alertă la prag
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Alertă la 80% din limită
# Obțineți limita
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)
# Obțineți consumul curent
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)
# Verificați pragul
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"ALERTĂ: {ratio*100:.1f}% din limită atinsă")
print(f" Cheltuieli: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Trimiteți notificarea
Integrarea cu soluțiile de monitorizare
Combinați previzualizarea taxelor cu soluția dumneavoastră de monitorizare (Grafana, Datadog etc.) pentru a crea tablouri de bord pentru costuri în timp real:
# Obțineți suma curentă pentru a o trimite sistemului dumneavoastră de metrici
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
Ajustarea dinamică a limitelor
Limita nu este bătută în cuie pentru ciclul de facturare — și acesta este un lucru bun, deoarece viața produsului nu urmează calendarul contabil. Înainte de un vârf de trafic așteptat, un lansare de produs sau o campanie de marketing, creșteți temporar limita: nimic nu este mai rău decât o campanie plătită care trimite utilizatorii către un serviciu al cărui API refuză cererile din cauza unui plafon atins. Invers, dacă bugetul lunii este cheltuit mai repede decât se aștepta, scăderea limitei pentru restul ciclului transformă o derivă într-o constrângere controlată. Cel mai critic caz rămâne un incident de cost — o buclă în producție, un abuz detectat: scăderea imediată a limitei este butonul dumneavoastră de oprire de urgență, cel care oprește sângerarea în timp ce găsiți cauza.
# Creștere temporară pentru o lansare
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}'
# Resetare la limita normală după vârful de trafic
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}'
Puncte cheie
- Utilizați
GETșiPOSTpe/v1/billing/teams/{teamId}/postpaid/spending-limitspentru a vizualiza și seta limitele - Când limita este depășită, cererile API sunt refuzate (fără suprafacturare)
- Previzualizarea taxelor (
invoice/preview) vă permite să urmăriți consumul în timp real - Automatizați alertele la prag pentru a anticipa depășirile
- Adaptați limitele în funcție de mediu (dezvoltare, staging, producție)