Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Informācija par rēķiniem

Nodarbība 5 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Rēķinu pārvaldība, izmantojot API
  2. Rēķinu informācijas iegūšana
  3. Informācijas atjaunināšana
  4. Rēķinu iegūšana
  5. xAI rēķinu loģika
  6. Pašreizējo maksājumu apskate
  7. Galvenās atziņas

Rēķinu pārvaldība, izmantojot API

Management API sadaļa „Billing” ļauj programmētiski iegūt un atjaunināt rēķinu informāciju, saņemt rēķinus un uzraudzīt izdevumus. Vairs nav nepieciešams pastāvīgi pārslēgties uz konsoli, lai pārbaudītu maksājuma statusu.

GET
Iegūt
POST
Atjaunināt
4
Rēķinu statusi
Mēneša
Rēķinu cikls

Rēķinu informācijas iegūšana

Rēķinu dati var šķist nekaitīgi, līdz grāmatvedība noraida rēķinu nepareiza nosaukuma vai trūkstoša PVN numura dēļ. To pārbaude, izmantojot API, prasa tikai vienu pieprasījumu un novērš neatgriezeniskas kļūdas: kā norādīts zemāk esošajā piezīmē, jau izrakstītu rēķinu ar jauniem datiem ģenerēt atkārtoti nevar.

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

Atbilde satur reģistrētos rēķinu datus: uzņēmuma nosaukumu, adresi, valsti un, ja piemērojams, PVN numuru.

Informācijas atjaunināšana

Lai modificētu rēķinu informāciju:

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

Svarīga piezīme par esošajiem rēķiniem

Atjauninātā rēķinu informācija attiecas tikai uz nākotnes rēķiniem. Jūs nevarat atpakaļejoši ģenerēt rēķinu ar jauniem datiem. Pārbaudiet savu informāciju pirms rēķinu cikla beigām, lai nodrošinātu precīzu rēķinu izrakstīšanu.

Rēķinu iegūšana

Beigu punkts GET /v1/billing/teams/{teamId}/invoices atgriež jūsu rēķinu vēsturi:

# Rēķini konkrētam mēnesim
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Rēķini kopš noteikta mēneša
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Filtrēšanas parametri

  • billingCycle.year un billingCycle.month: iegūst rēķinus konkrētam ciklam
  • since.year un since.month: iegūst visus rēķinus kopš noteikta mēneša

Rēķinu statusi

No šiem četriem statusiem tikai viens prasa tūlītēju rīcību. FAILED nozīmē, ka maksājums nav veikts (beidzies kartes termiņš, sasniegts limits, strīds), un neapmaksāts rēķins galu galā noved pie pakalpojuma apturēšanas. Tas ir statuss, kas jums jāuzrauga automātiski, kā parādīts nodarbībā par maksājumu metodēm; pārējos trīs jūs varat vienkārši pārskatīt, bet uz šo ir jāreaģē ar brīdinājumu.

  • PENDING: rēķins tiek apstrādāts; maksājums vēl nav iekasēts
  • PAID: maksājums veiksmīgs
  • FAILED: maksājums neizdevās (beidzies kartes termiņš, nepietiekami līdzekļi u.c.)
  • WILL_NEVER_BE_CHARGED: rēķins nekad netiks apmaksāts (kredīts, korekcija)

xAI rēķinu loģika

Izpratne par to, kā mijiedarbojas abi režīmi, novērš nepareizu informācijas interpretāciju jūsu informācijas panelī. Priekšapmaksas kredīti tiek izmantoti pirmie; mēneša rēķini sāk darboties tikai tad, kad atlikums ir izsmelts. Nulles atlikums pie aktīva pakalpojuma nav anomālija: tas nozīmē, ka tagad patērējat uz pēcapmaksas bāzes, un mēneša beigās uzkrājas rēķins.

Priekšapmaksas kredīti

Iegādātie kredīti tiek iekasēti uzreiz pirkuma brīdī. Katrs API izsaukums patērē kredītus atkarībā no apstrādāto tokena skaits. Kredīti tiek izlietoti pirmie.

Mēneša rēķini (pēcapmaksa)

Ja jūsu kredīti ir izsmelti vai jums to nav, patēriņš tiek rēķināts mēneša beigās. Katra API izsaukuma izmaksas tiek aprēķinātas uzreiz, bet iekasēšana notiek cikla beigās.

Tokena skaitīšanas atšķirības

Sagaidiet neatbilstību starp jūsu lokālo skaitījumu un rēķina skaitījumu, un labāk to zināt iepriekš, nekā pavadīt pusdienu, meklējot cēloni. Rēķinu dati ir autoritatīvi: veidojiet izmaksu aplēses, balstoties uz analītikas API rādītājiem, nekad uz klienta pusē veiktu tokenizatora skaitījumu. Tas ir normāli: secinājumu (inference) galapunkti pievieno iekšējos tokenus apstrādei (sistēmas instrukcijas, formatēšana), kas nedaudz palielina rēķinā iekļauto skaitu salīdzinājumā ar neapstrādātu tekstu.

Pašreizējo maksājumu apskate

Lai apskatītu uzkrātos maksājumus pirms cikla beigām:

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

Šis priekšskatījums ir vienīgais veids, kā uzzināt pašreizējo summu pirms rēķina izrakstīšanas. Pārbaudot to reizi nedēļā, jūs padarāt mēneša rēķinus pārvaldāmus: jūs redzat izmaksu novirzi mēneša vidū, kad vēl ir laiks novirzīt trafiku uz lētāku modeli vai samazināt limitu.

Galvenās atziņas

  • Izmantojiet GET un POST uz /v1/billing/teams/{teamId}/billing-info, lai iegūtu un modificētu informāciju
  • Rēķiniem ir 4 statusi: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Rēķinu izmaiņas nav atpakaļejošas attiecībā uz esošajiem rēķiniem
  • xAI apvieno priekšapmaksas kredītus (prioritāte) un mēneša rēķinus
  • Maksājumu priekšskatījums (invoice/preview) ļauj paredzēt izmaksas