Mokėjimų informacija
Šiame puslapyje
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.
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
GETirPOSTadresu/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