Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Prepaid-tegoed

Les 8 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. xAI prepaid-model
  2. Uw saldo controleren
  3. Tegoed kopen (opwaarderen)
  4. Strategieën voor tegoedgebruik
  5. Saldo-monitoring
  6. Belangrijkste punten

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.

  1. Prepaid-tegoed beschikbaar: tokens worden afgetrokken van het prepaid-saldo
  2. Tegoed uitgeput: verbruik schakelt over op maandelijkse facturatie (achteraf)
  3. 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/balance geeft het saldo en de geschiedenis terug
  • POST /v1/billing/teams/{teamId}/prepaid/top-up koopt 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