Förbetalda krediter
På denna sida
xAIs förbetalda modell
Med förbetalda krediter köper du ett saldo i förväg som förbrukas när du gör API-anrop. Denna modell är idealisk för att kontrollera kostnaderna: du spenderar bara det du har köpt, utan några överraskningar i slutet av månaden. Krediter används före den månatliga faktureringen.
Kontrollera ditt saldo
Förbetalda krediter vänder på riskprofilen jämfört med månadsfakturering. Vid efterbetalning upptäcker du kostnaden först i efterhand; vid förbetalning sätts taket i förväg och värsta tänkbara scenario är att tjänsten avbryts – obehagligt, men begränsat. För ett team som utforskar API:et eller ett projekt med en fast budget är detta rätt avvägning.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret innehåller:
- Det aktuella saldot i dollar
- Påfyllnadshistoriken med datum och belopp
- Användningshistoriken per period
Köp krediter (fyll på)
För att fylla på ditt kreditkonto:
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
}'
Viktiga punkter om krediter
De fyra punkterna nedan har konkreta konsekvenser för hur du automatiserar. Den andra är särskilt viktig: krediter är icke-återbetalningsbara. Detta ensamt utesluter strategin att göra ett enda stort inköp “för säkerhets skull”. Små, frekventa påfyllningar är bättre, även om du automatiserar dem, än kapital som binds i ett projekt som kan ändra inriktning.
- Krediter debiteras omedelbart vid köp på din standardbetalningsmetod
- Förbetalda krediter är icke-återbetalningsbara (såvida inte lagen i din jurisdiktion kräver annat)
- Krediter förbrukas i första hand före den månatliga efterbetalningen
- Det finns inget angivet utgångsdatum för krediter – de finns tillgängliga tills de är förbrukade
Faktureringsflöde med krediter
Det är värt att känna till förbrukningsordningen innan du konfigurerar något, eftersom det avgör vad dina instrumentpaneler visar. Krediter går först, månadsfakturering tar över därefter: med andra ord, om ett förbetalt saldo ligger stilla på noll medan allt fungerar, har du redan bytt till efterbetalning utan att inse det.
- Förbetalda krediter tillgängliga: token dras från det förbetalda saldot
- Krediter slut: förbrukningen växlar till månadsfakturering (efterbetalning)
- Spenderingsgräns nådd: begäranden nekas
Strategier för kreditanvändning
Fast månadsbudget
Detta är strategin med hård budget: utan aktiverad månadsfakturering stoppar uttömda krediter anropen istället för att skapa skuld. Acceptera avvägningen – tjänsten avbryts, och det är bättre att detta är ett explicit val än en upptäckt en fredagskväll. Kombinera detta med larmet för lågt saldo som beskrivs senare.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Kontrollera saldo
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)
# Fyll på om saldot är lågt
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"Fyllde på ${top_up_amount:.2f}")
Projektallokering
Projektallokering har en fördel utöver redovisningen: saldot blir ett mått på framdriften. Om hälften av krediterna är förbrukade medan bara en fjärdedel av arbetet är klart, får du den informationen i tid, när det fortfarande finns möjlighet att besluta om att minska omfattningen eller byta modeller.
# Projektbudget: $500 över 3 månader
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}'
Övervaka sedan användningen via analysverktyg (nästa lektion) för att säkerställa att budgeten respekteras.
Övervakning av saldo
Larm vid lågt saldo
#!/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: lågt förbetalt saldo ($BALANCE $)"
# Skicka en notifiering
fi
Instrumentpanel för användning
Kombinera det förbetalda saldot med en förhandsvisning av efterbetalda avgifter för en komplett bild av dina kostnader:
# Förbetalt saldo
echo "=== Förbetalda krediter ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Nuvarande efterbetalda avgifter
echo "=== Efterbetalda avgifter ==="
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
Viktiga punkter
GET /v1/billing/teams/{teamId}/prepaid/balancereturnerar saldo och historikPOST /v1/billing/teams/{teamId}/prepaid/top-upköper krediter (debiteras omedelbart)- Förbetalda krediter är icke-återbetalningsbara
- Krediter förbrukas före månadsfakturering
- Automatisera påfyllningar med en minimigräns för att undvika avbrott
- Kombinera förbetalda krediter och spenderingsgränser för total kostnadskontroll