Predplatené kredity
Na tejto strane
Model predplatených kreditov xAI
Predplatené kredity ti umožňujú nakúpiť si zostatok vopred, ktorý sa spotrebúva pri volaniach API. Tento model je ideálny na kontrolu výdavkov: míňaš len to, čo si kúpil, bez nepríjemných prekvapení na konci mesiaca. Kredity sa využívajú pred mesačnou fakturáciou.
Kontrola zostatku
Predplatený model obracia vzťah rizika v porovnaní s mesačnou fakturáciou. Pri platbe po spotrebe zistíš sumu až na konci; pri predplatenej forme je strop stanovený vopred a najhorším scenárom je prerušenie služby – nepríjemné, ale ohraničené. Pre tím, ktorý skúma API, alebo projekt s fixným rozpočtom je to správny kompromis.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpoveď obsahuje:
- Aktuálny zostatok v dolároch
- Históriu dobíjaní s dátumami a sumami
- Históriu využitia podľa období
Nákup kreditov (dobitie)
Na dobitie kreditného zostatku:
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
}'
Dôležité body týkajúce sa kreditov
Štyri body nižšie majú konkrétne dôsledky pre spôsob, akým automatizuješ procesy. Druhý bod je obzvlášť dôležitý: kredity nie je možné vrátiť. To samo o sebe vylučuje stratégiu jednorazového veľkého nákupu „pre istotu“ – skromnejšie a častejšie dobíjania sú lepšie, aj keď ich automatizuješ, než kapitál viazaný v projekte, ktorý môže zmeniť smer.
- Kredity sa účtujú okamžite pri nákupe na tvoju predvolenú platobnú metódu
- Predplatené kredity nie je možné vrátiť (pokiaľ to nevyžaduje zákon v tvojej jurisdikcii)
- Kredity sa spotrebúvajú prednostne pred mesačnou fakturáciou po spotrebe
- Pre kredity nie je uvedený žiadny dátum exspirácie – zostávajú dostupné, kým sa nespotrebujú
Tok fakturácie s kreditmi
Stojí za to poznať poradie spotreby pred konfiguráciou čohokoľvek, pretože určuje, čo zobrazujú tvoje dashboardy. Kredity idú ako prvé, mesačná fakturácia preberá kontrolu až afterward: inými slovami, predplatený zostatok stagnujúci na nule, zatiaľ čo všetko funguje, znamená, že si už prešiel na fakturáciu po spotrebe, aniž by si si to uvedomil.
- Dostupné predplatené kredity: tokeny sa odpočítavajú z predplateného zostatku
- Vyčerpané kredity: spotreba sa prepne na mesačnú fakturáciu (po spotrebe)
- Dosiahnutý limit výdavkov: požiadavky sú odmietnuté
Stratégie využívania kreditov
Fixný mesačný rozpočet
Toto je stratégia tvrdého rozpočtu: bez povolenej mesačnej fakturácie vyčerpanie kreditov zastaví volania namiesto generovania dlhu. Akceptuj kompromis – služba sa preruší a je lepšie, ak je to explicitná voľba, než objav v piatok večer. Skombinuj to s alertom na nízky zostatok, ktorý je opísaný nižšie.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Kontrola zostatku
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)
# Dobitie, ak je zostatok nízky
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"Dobité ${top_up_amount:.2f}")
Provisioning projektu
Provisioning projektu má výhodu nielen v účtovníctve: zostatok sa stáva mierou pokroku. Ak je spotrebovaná polovica kreditov, zatiaľ čo hotová je len štvrtina práce, získavaš túto informáciu skôr, než je neskoro, keď je ešte čas rozhodnúť sa, či obmedziť rozsah alebo prepnúť modely.
# Rozpočet projektu: 500 $ na 3 mesiace
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}'
Následne monitoruj využitie prostredníctvom analytiky (ďalšia lekcia), aby si zabezpečil dodržanie rozpočtu.
Monitorovanie zostatku
Alert na nízky zostatok
#!/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: nízky predplatený zostatok ($BALANCE $)"
# Odoslať notifikáciu
fi
Dashboard využitia
Skombinuj predplatený zostatok s náhľadom na poplatky po spotrebe, aby si získal kompletný prehľad o svojich nákladoch:
# Predplatený zostatok
echo "=== Predplatené kredity ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Aktuálne poplatky po spotrebe
echo "=== Poplatky po spotrebe ==="
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
Kľúčové poznatky
GET /v1/billing/teams/{teamId}/prepaid/balancevracia zostatok a históriuPOST /v1/billing/teams/{teamId}/prepaid/top-upkupuje kredity (účtované okamžite)- Predplatené kredity nie je možné vrátiť
- Kredity sa spotrebúvajú pred mesačnou fakturáciou
- Automatizuj dobíjanie s minimálnym prahom, aby si predišiel prerušeniam
- Skombinuj predplatené kredity a limity výdavkov pre totálnu kontrolu nákladov