Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Fakturačné údaje

Lekcia 5 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Správa fakturácie prostredníctvom API
  2. Získanie fakturačných údajov
  3. Aktualizácia údajov
  4. Získanie faktúr
  5. Logika fakturácie xAI
  6. Zobrazenie aktuálnych poplatkov
  7. Kľúčové poznatky

Správa fakturácie prostredníctvom API

Sekcia Billing (Fakturácia) v Management API ti umožňuje programovo získavať a aktualizovať tvoje fakturačné údaje, sťahovať faktúry a monitorovať výdavky. Už nemusíš neustále prepínať medzi konzolou a aplikáciou, aby si skontroloval stav platieb.

GET
Získať
POST
Aktualizovať
4
Stavy faktúr
Mesačný
Fakturačný cyklus

Získanie fakturačných údajov

Fakturačné detaily sa môžu zdať neškodné, kým účtovné oddelenie neodmietne faktúru kvôli nesprávnemu názvu alebo chýbajúcemu DIČ. Overenie týchto údajov prostredníctvom API si vyžiada len jednu požiadavku a predídeš tak neopraviteľnej chybe: ako vysvetľuje poznámka nižšie, vystavenú faktúru s novými údajmi už nie je možné vygenerovať znova.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Odpoveď obsahuje registrované fakturačné údaje: názov spoločnosti, adresu, krajinu a prípadne DIČ.

Aktualizácia údajov

Ak chceš upraviť svoje fakturačné údaje:

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"
  }'

Dôležitá poznámka k existujúcim faktúram

Aktualizované fakturačné údaje sa vzťahujú len na budúce faktúry. Nie je možné spätne vygenerovať faktúru s novými údajmi. Svoje údaje si over pred skončením fakturačného cyklu, aby si zabezpečil správnosť faktúr.

Získanie faktúr

Koncový bod GET /v1/billing/teams/{teamId}/invoices vráti históriu tvojich faktúr:

# Faktúry za konkrétny mesiac
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Faktúry od daného mesiaca
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Parametre filtrovania

  • billingCycle.year a billingCycle.month: získanie faktúr za konkrétny cyklus
  • since.year a since.month: získanie všetkých faktúr od daného mesiaca

Stavy faktúr

Z týchto štyroch stavov si len jeden vyžaduje okamžitú akciu. Stav FAILED (Zlyhané) znamená, že platba neprešla – vypršaná karta, dosiahnutý limit, spor – a nezaplatená faktúra nakoniec vedie k pozastaveniu služby. Toto je stav, ktorý musíš automaticky monitorovať, ako je ukázané v lekcii o platobných metódach; ostatné tri stavy len kontroluješ, ale pri tomto nastavuješ alert.

  • PENDING: faktúra sa spracováva; platba ešte nebola strhnutá
  • PAID: platba bola úspešná
  • FAILED: strhnutie platby zlyhalo (vypršaná karta, nedostatočné prostriedky atď.)
  • WILL_NEVER_BE_CHARGED: faktúra nikdy nebude spoplatnená (úver, úprava)

Logika fakturácie xAI

Pochopenie interakcie medzi týmito dvoma režimami predchádza nesprávnemu výkladu údajov na dashboarde. Predplatené kredity sa použijú ako prvé; mesačná fakturácia sa aktivuje až po vyčerpaní zostatku. Nulový zostatok pri aktívnej službe nie je anomália: znamená to, že teraz spotrebúvaš na postpaid báze a koncomesačná faktúra sa akumuluje.

Predplatené kredity

Zakúpené kredity sa účtujú okamžite v čase nákupu. Každé volanie API spotrebúva kredity na základe počtu spracovaných tokenov. Kredity sa míňajú ako prvé.

Mesačná fakturácia (postpaid)

Ak sú tvoje kredity vyčerpané alebo žiadne nemáš, spotreba sa fakturuje na konci mesiaca. Náklady na každé volanie API sa vypočítajú okamžite, ale strhnutie sumy nastane až na konci cyklu.

Rozdiely v počítaní tokenov

Počítaj s rozdielom medzi tvojím lokálnym počtom a fakturačným počtom a je lepšie vedieť o tom skôr, než stráviš pol dňa hľadaním príčiny. Rozhodujúca je fakturácia: svoje odhady nákladov zakladaj na údajoch z Analytics API, nikdy na počte získanom pomocou tokenizéra na strane klienta. Je to normálne: inferenčné koncové body pridávajú interné tokeny na spracovanie (systémové inštrukcie, formátovanie), čo mierne zvyšuje fakturovaný počet v porovnaní so surovým textom.

Zobrazenie aktuálnych poplatkov

Ak chceš zobraziť akumulované poplatky pred skončením cyklu:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Tento náhľad je jediným spôsobom, ako zistiť aktuálnu sumu pred vystavením faktúry. Ak ho kontroluješ raz týždenne, zmeníš mesačnú fakturáciu na niečo zvládnuteľné: v polovici mesiaca uvidíš odklon v nákladoch, keď je ešte čas presmerovať prevádzku na lacnejší model alebo znížiť limit.

Kľúčové poznatky

  • Použi GET a POST na /v1/billing/teams/{teamId}/billing-info na získanie a úpravu údajov
  • Faktúry majú 4 stavy: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Zmeny vo fakturácii nie sú spätné pre existujúce faktúry
  • xAI kombinuje predplatené kredity (priorita) a mesačnú fakturáciu
  • Náhľad poplatkov (invoice/preview) ti umožňuje anticipovať náklady