Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Faktureringsinformation

Lektion 5 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Hantera fakturering via API:t
  2. Hämta faktureringsinformation
  3. Uppdatera information
  4. Hämta fakturor
  5. xAI:s faktureringslogik
  6. Visa aktuella debiteringar
  7. Viktiga punkter

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.

GET
Hämta
POST
Uppdatera
4
Fakturastatusar
Månadsvis
Faktureringscykel

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 GET och POST på /v1/billing/teams/{teamId}/billing-info fö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