Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Podaci o naplati

Lekcija 5 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Upravljanje naplatom putem API-ja
  2. Dohvaćanje podataka o naplati
  3. Ažuriranje podataka
  4. Dohvaćanje računa
  5. xAI logika naplate
  6. Pregled trenutnih troškova
  7. Ključne točke

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.

GET
Dohvati
POST
Ažuriraj
4
Statusi računa
Mjesečno
Ciklus naplate

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 GET i POST na /v1/billing/teams/{teamId}/billing-info za 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