Arveldusteave
Sellel lehel
Arvelduse haldamine API kaudu
Management API arveldusjaotis võimaldab sul programmeeritult hankida ja uuendada oma arveldusteavet, pärida arveid ning jälgida kulusid. Enam ei pea maksestaatuse kontrollimiseks konsooli ja tagasi hüppama.
Arveldusteabe pärimine
Arveldusandmed võivad tunduda kahjutuna, kuni raamatupidamine lükkab arve tagasi vale nime või puuduva KM-numbri tõttu. Nende API kaudu kontrollimine võtab aega ühe päringu ja hoiab ära parandamatu vea: nagu allpool olev märkus selgitab, ei saa väljastatud arvet uute andmetega uuesti genereerida.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastus sisaldab registreeritud arveldusandmeid: ettevõtte nimi, aadress, riik ja vajadusel KM-number.
Teabe uuendamine
Arveldusteabe muutmiseks:
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"
}'
Oluline märkus olemasolevate arvete kohta
Uuendatud arveldusteave kehtib ainult tulevastele arvetele. Sa ei saa tagasiulatuvalt arvet uute andmetega uuesti genereerida. Veendu oma andmete õigsuses enne arveldustsükli lõppu, et tagada korrektsete arvete väljastamine.
Arvete pärimine
Lõpp-punkt GET /v1/billing/teams/{teamId}/invoices tagastab sinu arvete ajaloo:
# Konkreetse kuu arved
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Arved alates kindlast kuust
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Filtreerimisparameetrid
- billingCycle.year ja billingCycle.month: päri arved konkreetse tsükli kohta
- since.year ja since.month: päri kõik arved alates kindlast kuust
Arvete staatused
Nendest neljast staatusest nõuab vaid üks viivitamatut tegevust. FAILED tähendab, et makse ei õnnestunud – aegunud kaart, limiit ületatud, vaidlus – ja tasumata arve viib lõpuks teenuse peatamiseni. Just seda staatust pead automaatselt jälgima, nagu näidatud makseviiside õppetükis; ülejäänud kolme saad lihtsalt üle vaadata, kuid just sellele seadista häired.
- PENDING: arvet töödeldakse; makset ei ole veel maha kantud
- PAID: makse õnnestus
- FAILED: makse ebaõnnestus (aegunud kaart, vahendite puudumine jne)
- WILL_NEVER_BE_CHARGED: arvet ei hakata kunagi tasuma (krediit, korrigeerimine)
xAI arveldusloogika
Kahe režiimi koostoime mõistmine hoiab ära oma armatuurlaua valesti tõlgendamise. Esmalt kasutatakse ettemakstud krediidipunkte; igakuine arveldamine käivitub alles siis, kui saldo on ammendunud. Nullsaldo aktiivse teenuse korral ei ole anomaalia: see tähendab, et tarbid nüüd järelmaksu alusel ja kuu lõpu arve koguneb.
Ettemakstud krediidipunktid
Ostetud krediidipunktid kantakse maha kohe ostu hetkel. Iga API väljakutse tarbib krediidipunkte vastavalt töödeldud tokenite arvule. Krediidipunkte kasutatakse esimesena.
Igakuine arveldamine (järelmaks)
Kui sinu krediidipunktid on otsas või sul neid üldse pole, arveldatakse tarbimine kuu lõpus. Iga API väljakutse maksumus arvutatakse koheselt, kuid maha kandmine toimub tsükli lõpus.
Tokenite lugemise erinevused
Oota lahknevust oma kohaliku loenduse ja arveldusloenduse vahel ning parem on seda teada enne, kui kulutad pool päeva selle põhjuse otsimisele. Arveldus on autoriteetne: põhine oma kuluhinnangutel analüütika API näitajatel, mitte kunagi kliendipoolsel tokenisaatoril tehtud loendusel. See on normaalne: järelduspunktid lisavad töötlemiseks sisemisi tokeneid (süsteemijuhised, vormindamine), mis suurendab arveldatavat kogust veidi võrreldes toortekstiga.
Praeguste tasude vaatamine
Enne tsükli lõppu kogunenud tasude vaatamiseks:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
See eelvaade on ainus viis teada saada praegust summat enne arve väljastamist. Kui kontrollid seda kord nädalas, muutub igakuine arveldamine hallatavaks: näed kulude kõrvalekallet kuu keskel, kui on veel aega suunata liiklus odavamale mudelile või vähendada limiiti.
Peamised punktid
- Kasuta
GETjaPOSTlõpp-punktil/v1/billing/teams/{teamId}/billing-infoteabe pärimiseks ja muutmiseks - Arvetel on 4 staatust: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Arveldusmuudatused ei kehti tagasiulatuvalt olemasolevatele arvetele
- xAI ühendab ettemakstud krediidipunktid (esmatähtsad) ja igakuise arvelduse
- Tasude eelvaade (
invoice/preview) võimaldab kulusid ette näha