Faktureringsoplysninger
På denne side
Administrer fakturering via API’et
Sektionen for fakturering i Management API’et giver dig mulighed for at hente og opdatere dine faktureringsoplysninger, downloade fakturaer og overvåge forbrug – helt programmatisk. Du slipper for konstant at skulle hoppe frem og tilbage til konsollen for at tjekke betalingsstatus.
Hent faktureringsoplysninger
Faktureringsdetaljer kan virke harmløse, indtil regnskabet afviser en faktura på grund af et forkert firmanavn eller et manglende momsnummer. At verificere dem via API’et kræver kun én anmodning og forhindrer en uoprettelig fejl: Som bemærkningen nedenfor forklarer, kan du ikke genudstede en allerede udstedt faktura med nye oplysninger.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret indeholder de registrerede faktureringsdetaljer: firmanavn, adresse, land og momsnummer, hvis det er relevant.
Opdater oplysninger
For at ændre dine faktureringsoplysninger:
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"
}'
Vigtig bemærkning om eksisterende fakturaer
Opdaterede faktureringsoplysninger gælder kun for fremtidige fakturaer. Du kan ikke tilbagevirkende genudstede en faktura med nye detaljer. Verificér dine oplysninger før faktureringscyklussen slutter for at sikre korrekte fakturaer.
Hent fakturaer
Endpoint’et GET /v1/billing/teams/{teamId}/invoices returnerer din fakturahistorik:
# Fakturaer for en specifik måned
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Fakturaer siden en given måned
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Filtreringsparametre
- billingCycle.year og billingCycle.month: Hent fakturaer for en specifik cyklus
- since.year og since.month: Hent alle fakturaer siden en given måned
Fakturastatusser
Af disse fire statusser er der kun én, der kræver øjeblikkelig handling. FAILED betyder, at betalingen ikke gik igennem – udløbet kort, grænse nået, tvist – og en ubetalt faktura vil i sidste ende føre til suspension af tjenesten. Det er denne status, du skal overvåge automatisk, som vist i lektionen om betalingsmetoder; du gennemgår de andre tre, men du sender alarmer for denne.
- PENDING: Fakturaen behandles; betalingen er endnu ikke trukket
- PAID: Betalingen lykkedes
- FAILED: Betalingen mislykkedes (udløbet kort, utilstrækkelige midler osv.)
- WILL_NEVER_BE_CHARGED: Fakturaen vil aldrig blive opkrævet (kredit, justering)
xAIs faktureringslogik
At forstå, hvordan de to tilstande interagerer, forhindrer fejltolkninger af dit dashboard. Forudbetalte credits bruges først; månedlig fakturering træder først i kraft, når saldoen er opbrugt. En nulsaldo med aktiv tjeneste er ikke en anomali: Det betyder, at du nu forbruger på efterbetalingsbasis, og fakturaen ved månedens udgang akkumuleres.
Forudbetalte credits
Købte credits opkræves øjeblikkeligt på købstidspunktet. Hvert API-kald forbruger credits baseret på antallet af behandlede tokens. Credits bruges først.
Månedlig fakturering (efterbetaling)
Hvis dine credits er opbrugt, eller hvis du ikke har nogen, faktureres forbruget ved månedens udgang. Omkostningerne ved hvert API-kald beregnes øjeblikkeligt, men selve opkrævningen sker ved cyklussens afslutning.
Forskelle i optælling af tokens
Forvent en uoverensstemmelse mellem din lokale optælling og faktureringsoptællingen, og det er bedst at vide dette, før du spilder en halv dag på at spore det. Faktureringen er autoritativ: Basér dine omkostningsestimater på tallene fra analytics-API’et, aldrig på en optælling udført med en client-side tokenizer. Dette er normalt: Inferens-endpoints tilføjer interne tokens til behandling (systeminstruktioner, formatering), hvilket øger det fakturerede antal lidt sammenlignet med råteksten.
Se aktuelle omkostninger
For at se akkumulerede omkostninger før cyklussens afslutning:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Denne forhåndsvisning er den eneste måde at kende det aktuelle beløb på, før fakturaen udstedes. Tjekker du den én gang om ugen, bliver månedlig fakturering håndterbar: Du ser omkostningsafvigelser midt i måneden, hvor der stadig er tid til at omdirigere trafik til en billigere model eller sænke en grænse.
Vigtige pointer
- Brug
GETogPOSTpå/v1/billing/teams/{teamId}/billing-infotil at hente og ændre oplysninger - Fakturaer har 4 statusser: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Ændringer i fakturering er ikke tilbagevirkende på eksisterende fakturaer
- xAI kombinerer forudbetalte credits (prioritet) og månedlig fakturering
- Forhåndsvisningen af omkostninger (
invoice/preview) giver dig mulighed for at forudse udgifter