Podaci o naplati
Na ovoj stranici
Upravljanje naplatom putem API-ja
Odjeljak „Naplaćivanje“ (Billing) unutar Management API-ja omogućuje ti programsko dohvaćanje i ažuriranje podataka o naplati, preuzimanje računa te praćenje troškova. Više nema potrebe za stalnim prebacivanjem između konzole i provjere statusa plaćanja.
Dohvaćanje podataka o naplati
Detalji o naplati mogu djelovati bezazleno sve dok računovodstvo ne odbije račun zbog pogrešnog naziva ili nedostatnog PDV broja. Provjera tih podataka putem API-ja zahtijeva samo jedan zahtjev i sprječava nepopravljive greške: kao što objašnjava napomena u nastavku, izdani račun nije moguće ponovno generirati s novim podacima.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor sadrži registrirane podatke o naplati: naziv tvrtke, adresu, državu i PDV broj (ako je primjenjivo).
Ažuriranje podataka
Za izmjenu podataka o naplati:
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"
}'
Važna napomena o postojećim računima
Ažurirani podaci o naplati primjenjuju se isključivo na buduće račune. Ne možeš retroaktivno regenerirati račun s novim detaljima. Provjeri svoje podatke prije završetka obračunskog ciklusa kako bi osigurao/la točnost računa.
Dohvaćanje računa
Krajnja točka GET /v1/billing/teams/{teamId}/invoices vraća povijest tvojih računa:
# Računi za određeni mjesec
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 određenog mjeseca nadalje
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 filtriranja
- billingCycle.year i billingCycle.month: dohvaćanje računa za određeni ciklus
- since.year i since.month: dohvaćanje svih računa od određenog mjeseca nadalje
Statusi računa
Od ova četiri statusa, samo jedan zahtijeva hitnu reakciju. FAILED (Neuspjelo) znači da naplata nije prošla – istekla kartica, dosegnut limit, spor – a neplaćeni račun na kraju dovodi do suspenzije usluge. To je status koji moraš automatski pratiti, kako je prikazano u lekciji o načinima plaćanja; ostala tri statusa samo pregledavaš, ali na ovaj moraš postaviti alert.
- PENDING: račun se obrađuje; plaćanje još nije izvršeno
- PAID: plaćanje je bilo uspješno
- FAILED: naplata nije uspjela (istekla kartica, nedostatna sredstva itd.)
- WILL_NEVER_BE_CHARGED: račun nikada neće biti naplaćen (odobrenje, korekcija)
xAI logika naplate
Razumijevanje interakcije između ova dva načina rada sprječava pogrešno tumačenje podataka na nadzornoj ploči. Prepaid krediti troše se prvi; mjesečna naplata aktivira se tek kada se stanje iscrpi. Nulto stanje uz aktivnu uslugu nije anomalija: to znači da sada trošiš na postpaid osnovi, a račun za kraj mjeseca se akumulira.
Prepaid krediti
Kupljeni krediti naplaćuju se odmah u trenutku kupnje. Svaki poziv API-ju troši kredite na temelju broja obrađenih tokena. Krediti se troše prvi.
Mjesečna naplata (postpaid)
Ako su ti krediti iscrpljeni ili ih nemaš, potrošnja se naplaćuje na kraju mjeseca. Trošak svakog poziva API-ju izračunava se odmah, ali se stvarna naplata događa na kraju ciklusa.
Razlike u brojanju tokena
Očekuj odstupanje između tvog lokalnog brojanja i brojanja za naplatu; bolje je to znati unaprijed nego izgubiti pola dana tragajući za uzrokom. Naplata je mjerodavna: svoje procjene troškova temelji na podacima iz analytics API-ja, nikada na brojanju provedenom klijentskim tokenizatorom. To je normalno: inference endpointi dodaju interne tokene za obradu (sistemske upute, formatiranje), što neznatno povećava broj tokena za naplatu u usporedbi sa sirovim tekstom.
Pregled trenutnih troškova
Za pregled akumuliranih troškova prije završetka ciklusa:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ovaj pregled jedini je način da saznaš trenutni iznos prije izdavanja računa. Ako ga provjeravaš jednom tjedno, mjesečna naplata postaje upravljiva: uočit ćeš odstupanje u troškovima sredinom mjeseca, kada još imaš vremena preusmjeriti promet na jeftiniji model ili smanjiti limit.
Ključne točke
- Koristi
GETiPOSTna/v1/billing/teams/{teamId}/billing-infoza dohvaćanje i izmjenu podataka - Računi imaju 4 statusa: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Promjene u naplati nisu retroaktivne na postojeće račune
- xAI kombinira prepaid kredite (prioritet) i mjesečnu naplatu
- Pregled troškova (
invoice/preview) omogućuje ti anticipiranje troškova