Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Facturatiegegevens

Les 5 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Facturatie beheren via de API
  2. Facturatiegegevens ophalen
  3. Gegevens bijwerken
  4. Facturen ophalen
  5. xAI-logica voor facturatie
  6. Huidige kosten bekijken
  7. Belangrijkste punten

Facturatie beheren via de API

Met het gedeelte Facturatie van de Management API haalt u uw facturatiegegevens op en werkt u deze bij, vraagt u facturen aan en volgt u uw uitgaven; allemaal programmatisch. U hoeft niet meer heen en weer te springen naar de console om de betalingsstatus te controleren.

GET
Ophalen
POST
Bijwerken
4
Factuurstatussen
Maandelijks
Facturatiecyclus

Facturatiegegevens ophalen

Facturatiegegevens lijken onschuldig, totdat de boekhouding een factuur afkeurt vanwege een verkeerde naam of een ontbrekend btw-nummer. Het verifiëren ervan via de API kost slechts één verzoek en voorkomt een onoplosbare fout: zoals de onderstaande opmerking uitlegt, kunt u een reeds uitgegeven factuur niet opnieuw genereren met nieuwe gegevens.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Het antwoord bevat de geregistreerde facturatiegegevens: bedrijfsnaam, adres, land en, indien van toepassing, het btw-nummer.

Gegevens bijwerken

Om uw facturatiegegevens te wijzigen:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "My Company SAS",
    "address": "15 Peace Street",
    "city": "Paris",
    "country": "FR",
    "vatNumber": "FR12345678901"
  }'

Belangrijke opmerking over bestaande facturen

Bijgewerkte facturatiegegevens zijn alleen van toepassing op toekomstige facturen. U kunt een factuur niet met terugwerkende kracht opnieuw genereren met nieuwe gegevens. Verifieer uw gegevens voordat de facturatiecyclus eindigt om nauwkeurige facturen te garanderen.

Facturen ophalen

Het eindpunt GET /v1/billing/teams/{teamId}/invoices geeft uw factuurgeschiedenis terug:

# Facturen voor een specifieke maand
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Facturen sinds een bepaalde maand
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Filterparameters

  • billingCycle.year en billingCycle.month: haal facturen op voor een specifieke cyclus
  • since.year en since.month: haal alle facturen op sinds een bepaalde maand

Factuurstatussen

Van deze vier statussen vereist er slechts één onmiddellijke actie. FAILED betekent dat de afschrijving niet is gelukt—verlopen kaart, limiet bereikt, geschil—en een onbetaalde factuur leidt uiteindelijk tot opschorting van de dienst. Dit is de status die u automatisch moet bewaken, zoals getoond in de les over betaalmethoden; u bekijkt de andere drie, maar u stelt een alarm in voor deze.

  • PENDING: de factuur wordt verwerkt; de betaling is nog niet afgeschreven
  • PAID: de betaling is geslaagd
  • FAILED: de afschrijving is mislukt (verlopen kaart, onvoldoende saldo, enz.)
  • WILL_NEVER_BE_CHARGED: er zal nooit een afschrijving plaatsvinden voor deze factuur (tegoed, correctie)

xAI-logica voor facturatie

Inzicht in hoe de twee modi samenwerken, voorkomt misinterpretaties van uw dashboard. Prepaid-tegoed wordt als eerste gebruikt; maandelijkse facturatie start pas wanneer het saldo uitgeput is. Een nulsaldo met een actieve dienst is geen anomalie: het betekent dat u nu op achterafbetaalde basis consumeert en dat de factuur voor het einde van de maand zich opbouwt.

Prepaid-tegoed

Aangekocht tegoed wordt direct bij aankoop in rekening gebracht. Elke API-oproep verbruikt tegoed op basis van het aantal verwerkte tokens. Tegoed wordt als eerste gebruikt.

Maandelijkse facturatie (achterafbetaling)

Als uw tegoed uitgeput is of als u geen tegoed heeft, wordt het verbruik aan het einde van de maand gefactureerd. De kosten van elke API-oproep worden direct berekend, maar de afschrijving vindt plaats aan het einde van de cyclus.

Verschillen in tellen van tokens

Verwacht een discrepantie tussen uw lokale telling en de facturatiemelding; het is beter dit te weten voordat u een halve dag kwijt bent aan het opsporen ervan. De facturatie is leidend: baseer uw kostenschattingen op de cijfers van de analytics-API, nooit op een telling die is uitgevoerd met een client-side tokenizer. Dit is normaal: inferentie-eindpunten voegen interne tokens toe voor verwerking (systeeminstructies, opmaak), wat het gefactureerde aantal licht verhoogt ten opzichte van de ruwe tekst.

Huidige kosten bekijken

Om de opgebouwde kosten te bekijken voordat de cyclus eindigt:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Deze voorvertoning is de enige manier om het huidige bedrag te kennen voordat de factuur wordt uitgegeven. Als u dit eens per week controleert, wordt maandelijkse facturatie beheersbaar: u ziet kostenafwijkingen halverwege de maand, wanneer er nog tijd is om verkeer naar een goedkoper model te leiden of een limiet te verlagen.

Belangrijkste punten

  • Gebruik GET en POST op /v1/billing/teams/{teamId}/billing-info om gegevens op te halen en te wijzigen
  • Facturen hebben 4 statussen: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Wijzigingen in de facturatie zijn niet met terugwerkende kracht van toepassing op bestaande facturen
  • xAI combineert prepaid-tegoed (prioriteit) en maandelijkse facturatie
  • De kostenvoorvertoning (invoice/preview) stelt u in staat kosten te anticiperen