Laskutustiedot
Tällä sivulla
Laskutuksen hallinta API:n kautta
Management API:n laskutusosio mahdollistaa laskutustietojesi noutamisen ja päivittämisen, laskujen hakemisen sekä kulujen seurannan – kaikki ohjelmallisesti. Maksujen tilan tarkistamiseksi ei enää tarvitse hyppiä edestakaisin konsoliin.
Laskutustietojen noutaminen
Laskutustiedot voivat vaikuttaa harmittomilta, kunnes kirjanpito hylkää laskun väärän nimen tai puuttuvan ALV-numeron vuoksi. Tietojen tarkistaminen API:n kautta vie vain yhden pyynnön ja estää korjaamattoman virheen: kuten alla olevassa huomautuksessa selitetään, jo issued laskua ei voi luoda uudelleen uusilla tiedoilla.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastaus sisältää rekisteröidyt laskutustiedot: yrityksen nimi, osoite, maa ja tarvittaessa ALV-numeron.
Tietojen päivittäminen
Muuttaaksesi laskutustietojasi:
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"
}'
Tärkeä huomautus olemassa oleviin laskuihin
Päivitetyt laskutustiedot koskevat vain tulevia laskuja. Et voi taannehtivasti luoda uudelleen laskua uusilla tiedoilla. Varmista tietosi ennen laskutusjakson päättymistä varmistaaksesi oikeat laskut.
Laskujen noutaminen
Päätepiste GET /v1/billing/teams/{teamId}/invoices palauttaa laskuhistoriasi:
# Laskut tietylle kuukaudelle
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Laskut tietystä kuukaudesta lähtien
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Suodatusparametrit
- billingCycle.year ja billingCycle.month: noutaa laskut tietylle jaksolle
- since.year ja since.month: noutaa kaikki laskut tietystä kuukaudesta lähtien
Laskujen tilat
Näistä neljästä tilasta vain yksi vaatii välitöntä toimintaa. FAILED tarkoittaa, että veloitus epäonnistui – vanhentunut kortti, luottoraja ylitetty tai riitatilanne – ja maksamaton lasku johtaa lopulta palvelun keskeytykseen. Tämä on tila, jota sinun tulee seurata automaattisesti, kuten maksutapojen oppitunnissa esitetään; tarkistat muut kolme, mutta hälytät tästä.
- PENDING: laskua käsitellään; maksua ei ole vielä veloitettu
- PAID: maksu onnistui
- FAILED: veloitus epäonnistui (vanhentunut kortti, katteeton tili jne.)
- WILL_NEVER_BE_CHARGED: laskua ei koskaan veloiteta (hyvitys, oikaisu)
xAI:n laskutuslogiikka
Ymmärtämällä, miten nämä kaksi tilaa toimivat yhdessä, vältät virheelliset tulkinnat kojelaudallasi. Ennakkomaksutiedot käytetään ensin; kuukausilaskutus astuu voimaan vasta, kun saldo on tyhjentynyt. Nollasaldo aktiivisen palvelun kanssa ei ole poikkeama: se tarkoittaa, että kulutat nyt jälkikäteen laskutettavalla perusteella, ja kuukauden lopun lasku kertyy.
Ennakkomaksutiedot (Prepaid credits)
Ostetut tiedot veloitetaan välittömästi oston yhteydessä. Jokainen API-kutsu kuluttaa tietoja käsiteltyjen tokenien määrän perusteella. Tiedot käytetään ensin.
Kuukausilaskutus (jälkikäteen maksettava)
Jos tietosi loppuvat tai sinulla ei ole niitä, kulutus laskutetaan kuukauden lopussa. Jokaisen API-kutsun kustannus lasketaan välittömästi, mutta veloitus tapahtuu jakson lopussa.
Token-laskennan erot
Oleta ero paikallisen laskentasi ja laskutuksen laskennan välillä, ja on parempi tietää tämä ennen kuin käytät puoli päivää sen jäljittämiseen. Laskutus on auktoriteetti: perusta kustannusarviosi analytiikka-API:n lukemiin, älä koskaan asiakaspuolen tokenisoijalla tehtyyn laskentaan. Tämä on normaalia: päättelypäätepisteet lisäävät sisäisiä tokeneita käsittelyä varten (järjestelmäohjeet, muotoilu), mikä kasvattaa hieman laskutettua määrää verrattuna raakatekstiin.
Nykyisten veloitusten tarkastelu
Nähdäksesi kertyneet veloitukset ennen jakson päättymistä:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Tämä esikatselu on ainoa tapa tietää nykyinen määrä ennen laskun lähettämistä. Tarkistettuna kerran viikossa se tekee kuukausilaskutuksesta hallittavaa: näet kustannusten poikkeaman kuukauden puolivälissä, jolloin on vielä aikaa ohjata liikennettä halvempaan malliin tai laskea rajaa.
Keskeiset asiat
GETjaPOSTosoitteeseen/v1/billing/teams/{teamId}/billing-infotietojen noutamiseksi ja muuttamiseksi- Laskuilla on 4 tilaa: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Laskutusmuutokset eivät ole taannehtivia olemassa oleviin laskuihin
- xAI yhdistää ennakkomaksutiedot (etuoikeutettu) ja kuukausilaskutuksen
- Veloitusten esikatselu (
invoice/preview) antaa sinun ennakoida kustannuksia