Prepaid-tegoed
Op deze pagina
xAI prepaid-model
Met prepaid-tegoed koopt u vooraf een saldo op dat wordt verbruikt naarmate u API-aanroepen doet. Dit model is ideaal om uw uitgaven onder controle te houden: u geeft alleen uit wat u heeft gekocht, zonder verrassingen aan het einde van de maand. Tegoed wordt verbruikt vóór de maandelijkse facturatie.
Uw saldo controleren
Prepaid draait de risicoverhouding om in vergelijking met maandelijkse facturatie achteraf. Bij achteraf betalen ontdekt u het bedrag pas aan het einde; bij vooraf betalen staat het maximumbedrag van tevoren vast en is het worstcasescenario een onderbreking van de dienst—onaangenaam, maar begrensd. Voor een team dat de API verkent of een project met een vast budget is dit de juiste afweging.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Het antwoord bevat:
- Het huidige saldo in dollars
- De opwaardeergeschiedenis met data en bedragen
- De gebruiksgeschiedenis per periode
Tegoed kopen (opwaarderen)
Om uw tegoedsaldo op te waarderen:
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
}'
Belangrijke punten over tegoed
De vier onderstaande punten hebben concrete gevolgen voor hoe u automatiseert. Het tweede punt is vooral belangrijk: tegoed is niet restitueerbaar. Dit alleen al sluit de strategie uit van één grote aankoop “voor de zekerheid”. Bescheiden, frequente opwaarderingen zijn beter, zelfs als u ze automatiseert, dan kapitaal dat vastzit in een project dat wellicht van koers verandert.
- Tegoed wordt direct bij aankoop afgeschreven van uw standaardbetaalmethode
- Prepaid-tegoed is niet restitueerbaar (tenzij wettelijk verplicht in uw rechtsgebied)
- Tegoed wordt voorrang verbruikt vóór de maandelijkse facturatie achteraf
- Er is geen vervaldatum vermeld voor tegoed; het blijft beschikbaar totdat het is verbruikt
Facturatiestroom met tegoed
Het is de moeite waard om de verbruiksvolgorde te kennen voordat u iets configureert, omdat dit bepaalt wat elk van uw dashboards weergeeft. Tegoed gaat eerst, maandelijkse facturatie neemt daarna het stokje over: met andere woorden, een prepaid-saldo dat op nul stagneert terwijl alles werkt, betekent dat u al bent overgeschakeld op achteraf betalen zonder het te beseffen.
- Prepaid-tegoed beschikbaar: tokens worden afgetrokken van het prepaid-saldo
- Tegoed uitgeput: verbruik schakelt over op maandelijkse facturatie (achteraf)
- Uitgavenlimiet bereikt: verzoeken worden geweigerd
Strategieën voor tegoedgebruik
Vast maandbudget
Dit is de strategie voor een strikt budget: zonder ingeschakelde maandelijkse facturatie stopt het uitputten van tegoed de aanroepen in plaats van schulden te genereren. Accepteer de afweging—de dienst wordt onderbroken, en het is beter dat dit een expliciete keuze is dan een ontdekking op een vrijdagavond. Combineer dit met de waarschuwing bij laag saldo die later wordt beschreven.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Saldo controleren
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)
# Opwaarderen als saldo laag is
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"Opgewaardeerd met ${top_up_amount:.2f}")
Projectvoorziening
Projectvoorziening heeft een voordeel dat verder gaat dan boekhouding: het saldo wordt een graadmeter voor de voortgang. Als de helft van het tegoed is verbruikt terwijl slechts een kwart van het werk is gedaan, krijgt u deze informatie voordat het te laat is, wanneer er nog tijd is om te beslissen of u de scope wilt verkleinen of van model wilt wisselen.
# Projectbudget: $500 over 3 maanden
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}'
Monitor vervolgens het gebruik via analytics (volgende les) om ervoor te zorgen dat het budget wordt gerespecteerd.
Saldo-monitoring
Waarschuwing bij laag 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: laag prepaid-saldo ($BALANCE $)"
# Stuur een melding
fi
Gebruiksdashboard
Combineer het prepaid-saldo met de voorbeeldweergave van de achteraf te betalen kosten voor een compleet overzicht van uw kosten:
# Prepaid-saldo
echo "=== Prepaid-tegoed ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Huidige achteraf te betalen kosten
echo "=== Achteraf te betalen kosten ==="
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
Belangrijkste punten
GET /v1/billing/teams/{teamId}/prepaid/balancegeeft het saldo en de geschiedenis terugPOST /v1/billing/teams/{teamId}/prepaid/top-upkoopt tegoed (direct afgeschreven)- Prepaid-tegoed is niet restitueerbaar
- Tegoed wordt verbruikt vóór de maandelijkse facturatie
- Automatiseer opwaarderingen met een minimumdrempel om onderbrekingen te voorkomen
- Combineer prepaid-tegoed en uitgavenlimieten voor totale kostenbeheersing