Informācija par rēķiniem
Šajā lapā
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.
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
GETunPOSTuz/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