Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Mokėjimų informacija

Paskaita 5 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Mokėjimų valdymas per API
  2. Mokėjimų informacijos gavimas
  3. Informacijos atnaujinimas
  4. Sąskaitų gavimas
  5. xAI mokėjimų logika
  6. Dabartinių mokesčių peržiūra
  7. Svarbiausi punktai

Mokėjimų valdymas per API

„Management API“ skiltis „Mokėjimai“ leidžia programiškai gauti ir atnaujinti mokėjimų informaciją, atsisiųsti sąskaitas faktūras bei stebėti išlaidas. Daugiau nereikia nuolat naršyti konsolėje norint patikrinti mokėjimo būsenos.

GET
Gauti
POST
Atnaujinti
4
Sąskaitų būsenos
Mėnesinis
Mokėjimo ciklas

Mokėjimų informacijos gavimas

Mokėjimų duomenys gali atrodyti nekenksmingi, kol apskaitos skyrius neatmeta sąskaitos dėl neteisingo pavadinimo ar trūkstamo PVM mokėtojo kodo. Jų patikrinimas per API užtrunka vieną užklausą ir apsaugo nuo nepataisomų klaidų: kaip paaiškinta pastaboje žemiau, išduotos sąskaitos su naujais duomenimis sugeneruoti iš naujo negalima.

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

Atsakyme pateikiama registruota mokėjimų informacija: įmonės pavadinimas, adresas, šalies kodas ir, jei taikoma, PVM mokėtojo kodas.

Informacijos atnaujinimas

Norėdami pakeisti mokėjimų informaciją:

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

Svarbi pastaba dėl esamų sąskaitų

Atnaujinta mokėjimų informacija taikoma tik būsimoms sąskaitoms. Esamos sąskaitos su naujais duomenimis perskaičiuoti negalima. Patikrinkite savo duomenis prieš pasibaigiant mokėjimo ciklui, kad sąskaitos būtų tiksliai išrašytos.

Sąskaitų gavimas

Galutinio taško GET /v1/billing/teams/{teamId}/invoices pagalba gausite savo sąskaitų istoriją:

# Konkretaus mėnesio sąskaitos
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Sąskaitos nuo tam tikro mėnesio
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Filtravimo parametrai

  • billingCycle.year ir billingCycle.month: gauti konkretaus ciklo sąskaitas
  • since.year ir since.month: gauti visas sąskaitas nuo nurodyto mėnesio

Sąskaitų būsenos

Iš šių keturių būsenų tik vienai reikia skubių veiksmų. FAILED reiškia, kad mokėjimas nepavyko – pasibaigusi kortelė, viršytas limitas arba ginčijamas mokėjimas – o nesumokėta sąskaita ilgainiui lemia paslaugų sustabdymą. Būtent šią būseną turite automatiškai stebėti, kaip parodyta pamokoje apie mokėjimo būdus; kitas tris galite tiesiog peržiūrėti, tačiau dėl šios turi ateiti įspėjimas.

  • PENDING: sąskaita apdorojama; mokėjimas dar nėra nuskaičiuotas
  • PAID: mokėjimas sėkmingas
  • FAILED: mokėjimas nepavyko (pasibaigusi kortelė, lėšų trūkumas ir kt.)
  • WILL_NEVER_BE_CHARGED: sąskaita niekada nebus apmokėta (kreditas, korekcija)

xAI mokėjimų logika

Supratimas, kaip sąveikauja šie du režimai, padės išvengti neteisingo prietaisų skydelio duomenų aiškinimo. Pirmiausia naudojami išankstinio apmokėjimo kreditai; mėnesinis atsiskaitymas įsigalioja tik išnaudojus likutį. Nulinis likutis veikiant paslaugai nėra anomalija: tai reiškia, kad dabar vartojate paslaugas atsiskaitydami galioje, o mėnesio pabaigos sąskaita kaupiama.

Išankstinio apmokėjimo kreditai

Įsigyti kreditai nuskaičiuojami iškart pirkimo metu. Kiekvienas API užklausimas sunaudoja kreditus pagal apdorotų tokenų skaičių. Kreditai naudojami pirmiausia.

Mėnesinis atsiskaitymas (atsiskaitymas galioje)

Jei jūsų kreditai baigėsi arba jų neturite, vartojimas apmokestinamas mėnesio pabaigoje. Kiekvieno API užklausimo kaina apskaičiuojama iškart, tačiau nuskaičiavimas įvyksta pasibaigus ciklui.

Tokenų skaičiavimo skirtumai

Tikėkitės neatitikimo tarp jūsų vietinio skaičiavimo ir mokėjimų sistemos skaičiavimo; geriau tai žinoti iš anksto, nei pusę dienos gaišti ieškant priežasties. Mokėjimų sistema yra autoritetinga: savo išlaidų įverčius grįskite analitikos API duomenimis, niekada nenaudokite kliento pusėje atlikto tokenizatoriaus skaičiavimo. Tai normalu: išvados galiniai taškai (inference endpoints) prideda vidinių tokenų apdorojimui (sistemos instrukcijos, formatavimas), todėl sąskaitoje nurodytas skaičius šiek tiek viršija grynojo teksto kiekį.

Dabartinių mokesčių peržiūra

Norėdami peržiūrėti sukauptus mokesčius prieš pasibaigiant ciklui:

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

Ši peržiūra yra vienintelis būdas sužinoti dabartinę sumą prieš išrašant sąskaitą. Tikrinant ją kartą per savaitę, mėnesinis atsiskaitymas tampa valdomas: išlaidų nukrypimą pastebėsite mėnesio viduryje, kai dar turite laiko nukreipti srautą į pigesnį modelį arba sumažinti limitą.

Svarbiausi punktai

  • Naudokite GET ir POST adresu /v1/billing/teams/{teamId}/billing-info, kad gautumėte ir pakeistumėte informaciją
  • Sąskaitos turi 4 būsenas: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Mokėjimų pakeitimai netaikomi atgaline data esamoms sąskaitoms
  • xAI derina išankstinio apmokėjimo kreditus (prioritetas) ir mėnesinį atsiskaitymą
  • Mokesčių peržiūra (invoice/preview) leidžia numatyti išlaidas