Előre fizetett kreditek
Ezen az oldalon
Az xAI előre fizetett modellje
Az előre fizetett kreditek lehetővé teszik, hogy előre megvásárolj egy egyenleget, amelyet az API-hívások során használsz fel. Ez a modell ideális a költségek kontrollálására: csak annyit költesz, amennyit vettél, így a hónap végén nem érhetnek meglepetések. A rendszer a krediteket a havi számlázás előtt használja fel.
Egyenleg ellenőrzése
Az előre fizetett modell megfordítja a kockázati viszonyt a havi számlázáshoz képest. Utólagos fizetés esetén csak a hónap végén tudod meg az összeget; előre fizetésnél viszont a limitet előre meghatározod, és a legrosszabb eset is csupán a szolgáltatás megszakadása – kellemetlen, de behatárolt. Egy API-t vizsgáló csapat vagy fix költségvetésű projekt esetén ez a megfelelő kompromisszum.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
A válasz a következőket tartalmazza:
- Az aktuális egyenleg dollárban
- A feltöltési előzmények dátumokkal és összegekkel
- A felhasználási előzmények időszakok szerint
Kreditek vásárlása (feltöltés)
A kredit-egyenleged feltöltéséhez:
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
}'
Fontos tudnivalók a kreditekről
Az alábbi négy pont konkrét következményekkel jár az automatizálásodra nézve. Különösen a második: a kreditek nem téríthetők vissza. Ez önmagában kizárja azt a stratégiát, hogy biztonsági okokból egyetlen nagy összegű vásárlást eszközölj. Jobb megoldás a szerényebb, gyakori feltöltés – még akkor is, ha ezeket automatizálod –, mintsem hogy tőkét köss le egy olyan projektben, amelynek az iránya megváltozhat.
- A kreditek vásárláskor azonnal terhelődnek az alapértelmezett fizetési módodon
- Az előre fizetett kreditek nem téríthetők vissza (kivéve, ha a joghatóságod ezt törvényileg előírja)
- A kreditek felhasználása elsőbbséget élvez a havi utólagos számlázással szemben
- A kreditek lejárati dátuma nincs meghatározva – addig maradnak elérhetők, amíg fel nem használod őket
Számlázási folyamat kreditekkel
Érdemes ismerned a felhasználási sorrendet bármilyen konfigurálás előtt, mivel ez határozza meg, mit látsz az egyes irányítópultjaidon. Először a kreditek fogynek, majd ezután lép életbe a havi számlázás: más szóval, ha egy előre fizetett egyenleg nullán stagnál, miközben minden működik, az azt jelenti, hogy észrevétlenül átváltottál az utólagos fizetésre.
- Előre fizetett kreditek elérhetők: a tokenek levonása az előre fizetett egyenlegből történik
- Kreditek kimerültek: a fogyasztás átvált a havi számlázásra (utólagos fizetés)
- Költési limit elérve: a kérések elutasításra kerülnek
Kreditfelhasználási stratégiák
Fix havi költségvetés
Ez a szigorú költségvetési stratégia: ha a havi számlázás nincs engedélyezve, a kreditek kimerülése leállítja a hívásokat ahelyett, hogy tartozást generálna. Vállald be ezt a kompromisszumot – a szolgáltatás megszakad, és jobb, ha ez egy tudatos döntés eredménye, mintsem egy péntek esti meglepetés. Kombináld ezt a később tárgyalt alacsony egyenlegre figyelmeztető rendszerrel.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Egyenleg ellenőrzése
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)
# Feltöltés, ha az egyenleg alacsony
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"Feltöltve: ${top_up_amount:.2f}")
Projekt előkészítése
A projekt előkészítésének (provisioning) van egy előnye a könyvelésen túl: az egyenleg a haladás mérőszámává válik. Ha a kreditek felét már felhasználtad, miközben a munka csak negyedét végezted el, időben értesülsz róla – még mielőtt vége lenne –, így van időd dönteni a hatókör csökkentéséről vagy a modellek váltásáról.
# Projekt költségvetés: 500 USD 3 hónapra
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}'
Ezután kövesd nyomon a felhasználást az analitikai eszközökkel (következő lecke), hogy biztosítsd a költségvetés betartását.
Egyenlegfigyelés
Alacsony egyenlegre figyelmeztetés
#!/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 "FIGYELMEZTETÉS: alacsony előre fizetett egyenleg ($BALANCE $)"
# Értesítés küldése
fi
Felhasználási irányítópult
Kombináld az előre fizetett egyleget az utólagos számlázás előzetes becslésével, hogy teljes képet kapj a költségeidről:
# Előre fizetett egyenleg
echo "=== Előre fizetett kreditek ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Jelenlegi utólagos terhelések
echo "=== Utólagos terhelések ==="
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
Főbb megállapítások
- A
GET /v1/billing/teams/{teamId}/prepaid/balancelekérdezés visszaadja az egyenleget és az előzményeket - A
POST /v1/billing/teams/{teamId}/prepaid/top-upkrediteket vásárol (azonnali terheléssel) - Az előre fizetett kreditek nem téríthetők vissza
- A kreditek felhasználása a havi számlázás előtt történik
- Automatizáld a feltöltéseket egy minimális küszöbérték beállításával a megszakítások elkerülése érdekében
- Kombináld az előre fizetett krediteket a költési limitekkel a teljes költségszabályozás érdekében