Podatki o obračunu
Na tej strani
Upravljanje obračuna prek API-ja
Razdelek Billing (Obračun) v Management API-ju ti omogoča programsko pridobivanje in posodabljanje podatkov o obračunu, prenos računov ter spremljanje stroškov. Ni ti treba več skakati med konzolo in drugimi vmesniki, da bi preveril stanje plačil.
Pridobivanje podatkov o obračunu
Podatki o obračunu se morda zdijo neškodljivi, dokler računovodstvo ne zavrne računa zaradi napačnega imena ali manjkajoče davčne številke. Preverjanje teh podatkov prek API-ja zahteva le en zahtevek in prepreči nepopravljivo napako: kot pojasnjuje spodnja opomba, izdanega računa z novimi podatki ni mogoče ponovno ustvariti.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor vsebuje registrirane podatke o obračunu: ime podjetja, naslov, državo in po potrebi davčno številko (VAT).
Posodabljanje podatkov
Če želiš spremeniti svoje podatke o obračunu:
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"
}'
Pomembna opomba glede obstoječih računov
Posodobljeni podatki o obračunu veljajo samo za prihodnje račune. Računa z novimi podatki ni mogoče naknadno ponovno ustvariti. Svoje podatke preveri pred koncem obračunskega obdobja, da zagotoviš točnost računov.
Pridobivanje računov
Končna točka GET /v1/billing/teams/{teamId}/invoices vrne tvojo zgodovino računov:
# Računi za določen mesec
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Računi od določenega meseca naprej
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Parametri za filtriranje
- billingCycle.year in billingCycle.month: pridobi račune za določeno obdobje
- since.year in since.month: pridobi vse račune od določenega meseca naprej
Statusi računov
Od teh štirih statusov le eden zahteva takojšnje ukrepanje. FAILED (neuspelo) pomeni, da bremenitev ni uspela – potekla kartica, dosežena omejitev, spor – in neplačan račun sčasoma vodi do začasne ustavitve storitve. To je status, ki ga moraš samodejno spremljati, kot je prikazano v lekciji o plačilnih metodah; ostale tri pregledaš, opozorila pa nastaviš za tega.
- PENDING: račun se obdeluje; plačilo še ni bilo bremenjeno
- PAID: plačilo je bilo uspešno
- FAILED: bremenitev ni uspela (potekla kartica, nezadostna sredstva itd.)
- WILL_NEVER_BE_CHARGED: račun ne bo nikoli bremenjen (dobropis, prilagoditev)
Logika obračuna xAI
Razumevanje interakcije med obema načinoma preprečuje napačno razlago podatkov na nadzorni plošči. Predplačniški krediti se porabijo prvi; mesečni obračun se vklopi šele, ko je stanje izčrpano. Ničelno stanje ob aktivni storitvi ni anomalija: pomeni, da zdaj porabljaš na podlagi naknadnega plačila (postpaid) in se konec meseca zbirajo stroški na računu.
Predplačniški krediti
Kupljeni krediti se zaračunajo takoj ob nakupu. Vsak klic API-ja porabi kredite glede na število obdelanih žetonov (tokenov). Krediti se porabijo prvi.
Mesečni obračun (naknadno plačilo)
Če so tvoji krediti porabljeni ali jih nimaš, se poraba zaračuna ob koncu meseca. Strošek vsakega klica API-ja se izračuna takoj, vendar do bremenitve pride šele ob koncu obdobja.
Razlike pri štetju žetonov
Pričakuj neskladje med svojim lokalnim štetjem in obračunskim štetjem; bolje je, da to veš, preden porabiš pol dneva za iskanje vzroka. Obračun je merodajen: svoje ocene stroškov temelji na podatkih analitičnega API-ja, nikoli na štetju, opravljenem s tokenizatorjem na strani odjemalca. To je normalno: končne točke za sklepanje (inference) dodajo notranje žetone za obdelavo (sistemska navodila, oblikovanje), kar nekoliko poveča obračunano število v primerjavi s surovim besedilom.
Ogled trenutnih stroškov
Če želiš pregledati nabrane stroške pred koncem obdobja:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ta predogled je edini način, da izveš trenutni znesek pred izdajo računa. Če ga preverjaš enkrat tedensko, postane mesečni obračun obvladljiv: sredi obdobja opaziš odstopanje stroškov, ko je še čas, da preusmeriš promet na cenejši model ali znižaš omejitev.
Ključne ugotovitve
- Uporabi
GETinPOSTna/v1/billing/teams/{teamId}/billing-infoza pridobivanje in spreminjanje podatkov - Računi imajo 4 statuse: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Spremembe obračuna niso retroaktivne za obstoječe račune
- xAI združuje predplačniške kredite (prednostno) in mesečni obračun
- Predogled stroškov (
invoice/preview) ti omogoča anticipacijo stroškov