Unaprijed plaćeni krediti
Na ovoj stranici
xAI model unaprijed plaćenih kredita
Unaprijed plaćeni krediti omogućuju ti kupnju stanja unaprijed, koje se troši kako vršiš API pozive. Ovaj je model idealan za kontrolu troškova: trošiš samo ono što si kupio, bez iznenađenja na kraju mjeseca. Krediti se koriste prije mjesečnog obračuna.
Provjera stanja
Unaprijed plaćeni model mijenja odnos rizika u usporedbi s mjesečnim obračunom. Kod naknadnog plaćanja iznos saznaješ na kraju; kod unaprijed plaćenog modela gornja granica postavljena je unaprijed, a najgori scenarij je prekid usluge – neugodno, ali ograničeno. Za tim koji istražuje API ili projekt s fiksnim proračunom, ovo je ispravan kompromis.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor sadrži:
- Trenutno stanje u dolarima
- Povijest dopuna s datumima i iznosima
- Povijest korištenja po razdobljima
Kupnja kredita (dopuna)
Za ponovno punjenje stanja kredita:
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 100.00
}'
Važne napomene o kreditima
Četiri točke u nastavku imaju konkretne posljedice na način na koji automatiziraš procese. Druga je posebno važna: krediti se ne mogu vratiti. To samo po sebi isključuje strategiju jedne velike kupnje „za svaki slučaj“ – skromne, česte dopune su bolje, čak i ako ih automatiziraš, od kapitala vezanog u projektu koji bi mogao promijeniti smjer.
- Krediti se naplaćuju odmah pri kupnji na tvoju zadanu metodu plaćanja
- Unaprijed plaćeni krediti su nepovratni (osim ako zakon u tvojoj jurisdikciji ne nalaže drugačije)
- Krediti se troše prioritetno prije mjesečnog naknadnog obračuna
- Nema navedenog datuma isteka za kredite – ostaju dostupni dok se ne potroše
Tijek naplaćivanja s kreditima
Vrijedi znati redoslijed potrošnje prije konfiguracije bilo čega, jer to određuje što prikazuju tvoje nadzorne ploče. Krediti idu prvi, mjesečni obračun preuzima nakon toga: drugim riječima, ako stanje unaprijed plaćenih sredstava stagnira na nuli dok sve radi, to znači da si već prešao na naknadno plaćanje, a da nisi ni shvatio.
- Dostupni unaprijed plaćeni krediti: tokeni se odbijaju od unaprijed plaćenog stanja
- Krediti potrošeni: potrošnja prelazi na mjesečni obračun (naknadno plaćanje)
- Dostignut limit potrošnje: zahtjevi se odbijaju
Strategije korištenja kredita
Fiksni mjesečni proračun
Ovo je strategija strogog proračuna: bez omogućenog mjesečnog obračuna, potrošnja kredita zaustavlja pozive umjesto generiranja duga. Prihvati kompromis – usluga se prekida, i bolje je da to bude eksplicitan izbor nego otkriće petkom navečer. Kombiniraj to s upozorenjem o niskom stanju opisanim kasnije.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Provjera stanja
balance_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
balance = balance_resp.json().get("balance", 0)
# Dopuna ako je stanje nisko
MONTHLY_BUDGET = 200.00
RECHARGE_THRESHOLD = 50.00
if balance < RECHARGE_THRESHOLD:
top_up_amount = MONTHLY_BUDGET - balance
requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/top-up",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={"amount": top_up_amount}
)
print(f"Dopunjeno ${top_up_amount:.2f}")
Opskrba projekta
Opskrba projekta ima prednost osim računovodstvene: stanje postaje mjera napretka. Ako je potrošena polovica kredita dok je obavljena samo četvrtina posla, tu informaciju dobivaš prije kraja, kada još imaš vremena odlučiti hoćeš li smanjiti opseg ili promijeniti modele.
# Proračun projekta: 500 $ tijekom 3 mjeseca
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 500.00}'
Zatim prati korištenje putem analitike (sljedeća lekcija) kako bi osigurao poštivanje proračuna.
Praćenje stanja
Upozorenje o niskom stanju
#!/bin/bash
BALANCE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('balance', 0))")
THRESHOLD=20.00
if (( $(echo "$BALANCE < $THRESHOLD" | bc -l) )); then
echo "UPOZORENJE: nisko stanje unaprijed plaćenih kredita ($BALANCE $)"
# Pošalji obavijest
fi
Nadzorna ploča korištenja
Kombiniraj stanje unaprijed plaćenih kredita s pregledom naknadnih troškova za potpun uvid u svoje troškove:
# Stanje unaprijed plaćenih kredita
echo "=== Unaprijed plaćeni krediti ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Trenutni naknadni troškovi
echo "=== Naknadni troškovi ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Ključne točke
GET /v1/billing/teams/{teamId}/prepaid/balancevraća stanje i povijestPOST /v1/billing/teams/{teamId}/prepaid/top-upkupuje kredite (naplaćuje se odmah)- Unaprijed plaćeni krediti su nepovratni
- Krediti se troše prije mjesečnog obračuna
- Automatiziraj dopune s minimalnim pragom kako bi izbjegao prekide
- Kombiniraj unaprijed plaćene kredite i limite potrošnje za potpunu kontrolu troškova