Faktureringsinformation
På denna sida
Hantera fakturering via API:t
Sektionen för fakturering i Management API låter dig hämta och uppdatera din faktureringsinformation, hämta fakturor och övervaka dina utgifter – helt programmatiskt. Sluta hoppa fram och tillbaka till konsolen för att kontrollera betalningsstatus.
Hämta faktureringsinformation
Faktureringsuppgifter kan verka harmlösa tills redovisningen nekar en faktura på grund av felaktigt företagsnamn eller saknat momsregistreringsnummer. Att verifiera dem via API:t tar bara en begäran och förhindrar ett oåterkalleligt fel: som notisen nedan förklarar kan du inte generera om en utfärdad faktura med nya uppgifter.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret innehåller de registrerade faktureringsuppgifterna: företagsnamn, adress, land och momsregistreringsnummer om tillämpligt.
Uppdatera information
För att ändra din faktureringsinformation:
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"
}'
Viktig notering om befintliga fakturor
Uppdaterad faktureringsinformation gäller endast för framtida fakturor. Du kan inte i efterhand generera om en faktura med nya uppgifter. Verifiera din information innan faktureringscykeln avslutas för att säkerställa korrekta fakturor.
Hämta fakturor
Slutpunkten GET /v1/billing/teams/{teamId}/invoices returnerar din fakturahistorik:
# Fakturor för en specifik månad
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Fakturor sedan en given månad
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Filtreringsparametrar
- billingCycle.year och billingCycle.month: hämta fakturor för en specifik cykel
- since.year och since.month: hämta alla fakturor sedan en given månad
Fakturastatusar
Av dessa fyra statusar kräver endast en omedelbar åtgärd. FAILED betyder att debiteringen misslyckades – utgånget kort, nådd gräns, tvist – och en obetald faktura leder så småningom till avstängd tjänst. Detta är den status du behöver övervaka automatiskt, som visas i lektionen om betalningsmetoder; du granskar de andra tre, men du skapar larm för denna.
- PENDING: fakturan bearbetas; betalning har ännu inte debiterats
- PAID: betalningen lyckades
- FAILED: debiteringen misslyckades (utgånget kort, otäckta medel, etc.)
- WILL_NEVER_BE_CHARGED: fakturan kommer aldrig att debiteras (kredit, justering)
xAI:s faktureringslogik
Att förstå hur de två lägena samverkar förhindrar feltolkningar av din instrumentpanel. Förbetalda krediter används först; månadsfakturering aktiveras först när saldot är förbrukat. Ett nollsaldo med aktiv tjänst är ingen anomali: det betyder att du nu konsumerar på efterhandsbasis och att fakturan för månadsslutet ackumuleras.
Förbetalda krediter
Köpta krediter debiteras omedelbart vid köptillfället. Varje API-anrop förbrukar krediter baserat på antalet bearbetade token. Krediter används i första hand.
Månadsfakturering (efterhands)
Om dina krediter är slut eller om du inte har några, faktureras konsumtionen i slutet av månaden. Kostnaden för varje API-anrop beräknas omedelbart, men själva debiteringen sker i slutet av cykeln.
Skillnader i tokenräkning
Förvänta dig en avvikelse mellan din lokala räkning och faktureringsräkningen, och det är bättre att veta detta innan du lägger en halv dag på att spåra det. Faktureringen är auktoritativ: basera dina kostnadsuppskattningar på siffror från analys-API:t, aldrig på en räkning utförd med en tokeniserare på klientsidan. Detta är normalt: inferensslutpunkter lägger till interna token för bearbetning (systeminstruktioner, formatering), vilket något ökar det fakturerade antalet jämfört med råtexten.
Visa aktuella debiteringar
För att visa ackumulerade debiteringar innan cykeln avslutas:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Denna förhandsvisning är det enda sättet att känna till det aktuella beloppet innan fakturan utfärdas. Kontrollerad en gång i veckan gör den månadsfakturering hanterbar: du ser kostnadsavvikelser mitt i månaden, när det fortfarande finns tid att omdirigera trafik till en billigare modell eller sänka en gräns.
Viktiga punkter
- Använd
GETochPOSTpå/v1/billing/teams/{teamId}/billing-infoför att hämta och ändra information - Fakturor har 4 statusar: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Faktureringsändringar är inte retroaktiva på befintliga fakturor
- xAI kombinerar förbetalda krediter (prioritet) och månadsfakturering
- Förhandsvisningen av debiteringar (
invoice/preview) låter dig förutse kostnader