Predplačniški krediti
Na tej strani
Predplačniški model xAI
Predplačniški krediti ti omogočajo vnaprejšnji nakup stanja, ki se porablja ob klicih API-ja. Ta model je idealen za nadzor stroškov: porabiš le to, kar si kupil, brez neprijetnih presenečenj ob koncu meseca. Krediti se porabijo pred mesečnim obračunom.
Preveri svoje stanje
Predplačilo obrne razmerje tveganja v primerjavi z mesečnim obračunom. Pri plačilu po opravljeni storitvi znesek izveš šele na koncu; pri predplačilu je zgornja meja določena vnaprej, najslabši scenarij pa je prekinitev storitve – neprijetno, a omejeno. Za ekipo, ki raziskuje API, ali projekt s fiksnim proračunom je to pravi kompromis.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor vsebuje:
- Trenutno stanje v dolarjih
- Zgodovino pologov z datumi in zneski
- Zgodovino porabe po obdobjih
Nakup kreditov (polog)
Za ponovno polnjenje stanja kreditov:
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
}'
Pomembne točke glede kreditov
Spodnje štiri točke imajo konkretne posledice za tvojo avtomatizacijo. Še posebej druga: krediti niso vračljivi. To samo po sebi izključuje strategijo enega samega velikega nakupa „za vsak slučaj”. Boljši so skromni, pogosti pologi, tudi če jih avtomatiziraš, kot kapital, vezan v projektu, ki bi lahko spremenil smer.
- Krediti se zaračunajo takoj ob nakupu na tvojo privzeto plačilno metodo
- Predplačniški krediti so nevračljivi (razen če to zahteva zakonodaja v tvoji jurisdikciji)
- Krediti se porabijo prednostno pred mesečnim obračunom po opravljeni storitvi
- Za kredite ni navedenega datuma poteka – na voljo so, dokler se ne porabijo
Potek obračuna s krediti
Pred konfiguracijo je vredno poznati vrstni red porabe, saj ta določa, kaj prikazujejo tvoje nadzorne plošče. Najprej gredo krediti, nato prevzame mesečni obračun: z drugimi besedami, če predplačniško stanje stagnira na ničli, medtem ko vse deluje, pomeni, da si že preklopil na obračun po opravljeni storitvi, ne da bi se tega zavedal.
- Razpoložljivi predplačniški krediti: žetoni se odštejejo od predplačniškega stanja
- Porabljeni krediti: poraba se preklopi na mesečni obračun (po opravljeni storitvi)
- Dosežena omejitev porabe: zahteve so zavrnjene
Strategije uporabe kreditov
Fiksni mesečni proračun
To je strategija trdega proračuna: brez vklopljenega mesečnega obračuna poraba kreditov ustavi klice namesto ustvarjanja dolga. Sprejmi kompromis – storitev se prekine, bolje pa je, da je to izrecna izbira, kot pa odkritje v petek zvečer. Združi to z opozorilom za nizko stanje, opisanim kasneje.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Preveri stanje
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)
# Ponovno napolni, če je stanje nizko
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"Recharged ${top_up_amount:.2f}")
Opremljanje projekta
Opremljanje projekta ima poleg računovodske prednosti še eno: stanje postane merilo napredka. Če je porabljena polovica kreditov, opravljeno pa le četrtino dela, to izveš pred koncem, ko je še čas za odločitev o zmanjšanju obsega ali zamenjavi modelov.
# Proračun projekta: 500 $ v 3 mesecih
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}'
Nato spremljaj porabo prek analitike (naslednja lekcija), da zagotoviš spoštovanje proračuna.
Spremljanje stanja
Opozorilo za nizko stanje
#!/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 "ALERT: low prepaid balance ($BALANCE $)"
# Pošlji obvestilo
fi
Nadzorna plošča za porabo
Združi predplačniško stanje s predogledom obremenitev po opravljeni storitvi za popoln pregled svojih stroškov:
# Predplačniško stanje
echo "=== Prepaid Credits ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Trenutne obremenitve po opravljeni storitvi
echo "=== Postpaid Charges ==="
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 ugotovitve
GET /v1/billing/teams/{teamId}/prepaid/balancevrne stanje in zgodovinoPOST /v1/billing/teams/{teamId}/prepaid/top-upkupi kredite (zaračunano takoj)- Predplačniški krediti so nevračljivi
- Krediti se porabijo pred mesečnim obračunom
- Avtomatiziraj pologe z minimalnim pragom, da se izogneš prekinitev
- Združi predplačniške kredite in omejitve porabe za popoln nadzor stroškov