Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Számlázási információk

5. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Számlázás kezelése az API-n keresztül
  2. Számlázási információk lekérése
  3. Információk frissítése
  4. Számlák lekérése
  5. xAI számlázási logika
  6. Aktuális terhelések megtekintése
  7. Főbb megállapítások

Számlázás kezelése az API-n keresztül

A Management API Számlázás szekciója lehetővé teszi a számlázási adataid lekérését és frissítését, a számlák lekérdezését, valamint a költések nyomon követését – mindezt programozottan. Többé nem kell ugrálnod a konzol és az API között a fizetési állapot ellenőrzéséhez.

GET
Lekérés
POST
Frissítés
4
Számla státuszok
Havi
Számlázási ciklus

Számlázási információk lekérése

A számlázási adatok ártalmatlannak tűnhetnek mindaddig, amíg a könyvelés vissza nem utasít egy számlát a helytelen név vagy a hiányzó ÁFA-szám miatt. Ezek API-n keresztüli ellenőrzése egyetlen kérést vesz igénybe, és megelőz egy javíthatatlan hibát: ahogy az alábbi megjegyzés is kifejti, a kiállított számlát nem lehet új adatokkal újra generálni.

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

A válasz tartalmazza a regisztrált számlázási adatokat: cégnév, cím, ország, és adott esetben az ÁFA-szám.

Információk frissítése

A számlázási adataid módosításához:

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

Fontos megjegyzés a meglévő számlákról

A frissített számlázási információk csak a jövőbeli számlákra vonatkoznak. Nem lehet visszamenőlegesen újragenerálni egy számlát új adatokkal. Ellenőrizd az adataidat mielőtt a számlázási ciklus lezárul, hogy biztosítsd a pontos számlázást.

Számlák lekérése

A GET /v1/billing/teams/{teamId}/invoices végpont visszaadja a számlaelőzményeidet:

# Számlák egy adott hónapra
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Számlák egy adott hónaptól kezdve
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Szűrési paraméterek

  • billingCycle.year és billingCycle.month: számlák lekérése egy adott ciklusra
  • since.year és since.month: összes számla lekérése egy adott hónaptól kezdve

Számla státuszok

E négy státusz közül csak egy igényel azonnali beavatkozást. A FAILED (sikertelen) azt jelenti, hogy a terhelés nem ment végbe – lejárt kártya, elérte a limitet, vitatott tétel –, és egy ki nem fizetett számla végül a szolgáltatás felfüggesztéséhez vezet. Ezt a státuszt kell automatikusan figyelned, ahogy azt a fizetési módokról szóló leckében láttad; a másik hármat csak átnézed, de erre kell riasztást beállítanod.

  • PENDING: a számla feldolgozás alatt áll; a fizetés még nem történt meg
  • PAID: a fizetés sikeres volt
  • FAILED: a terhelés sikertelen volt (lejárt kártya, fedezethiány stb.)
  • WILL_NEVER_BE_CHARGED: a számlát soha nem fogják terhelni (jóváírás, kiigazítás)

xAI számlázási logika

Annak megértése, hogyan lép kölcsönhatásba a két mód, megelőzi a műszerfalad félreértelmezését. Az előrefizetett krediteket használja fel a rendszer először; a havi számlázás csak akkor indul be, ha az egyenleg kimerült. A nulla egyenleg aktív szolgáltatás mellett nem anomália: azt jelenti, hogy most utólagos fizetési alapon fogyasztasz, és a hónap végi számla gyűlik össze.

Előrefizetett kreditek

A megvásárolt krediteket a vásárlás időpontában azonnal terhelik. Minden API-hívás a feldolgozott tokenek száma alapján fogyaszt krediteket. A krediteket használja fel a rendszer elsőként.

Havi számlázás (utólagos fizetés)

Ha a krediteid kimerültek, vagy nincs is belőlük, a fogyasztást a hónap végén számlázzák ki. Minden API-hívás költségét azonnal kiszámítják, de a terhelés csak a ciklus végén történik meg.

Token-számlálási különbségek

Számíts eltérésre a helyi számlálásod és a számlázási számlálás között, és jobb, ha ezt még azelőtt tudod, mielőtt fél napot töltenél a nyomozással. A számlázás a mérvadó: a költségbecsléseidet az analytics API adataira alapozd, soha ne a kliens oldali tokenizálóval végzett számlálásra. Ez normális: a következtetési (inference) végpontok belső tokeneket adnak hozzá a feldolgozáshoz (rendszerutasítások, formázás), ami kissé növeli a számlázott mennyiséget a nyers szöveghez képest.

Aktuális terhelések megtekintése

A ciklus vége előtt felhalmozódott terhelések megtekintéséhez:

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

Ez az előnézet az egyetlen módja annak, hogy megtudd az aktuális összeget a számla kiállítása előtt. Ha hetente egyszer ellenőrzöd, a havi számlázás kezelhetővé válik: időben látod a költségeltérést, amikor még van időd forgalmat olcsóbb modellre irányítani vagy limitet csökkenteni.

Főbb megállapítások

  • Használd a GET és POST módszereket a /v1/billing/teams/{teamId}/billing-info végponton az információk lekéréséhez és módosításához
  • A számláknak 4 státusza van: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • A számlázási változtatások nem visszamenőlegesek a meglévő számlákra
  • Az xAI kombinálja az előrefizetett krediteket (elsőbbségi) és a havi számlázást
  • A terhelések előnézete (invoice/preview) lehetővé teszi a költségek előrejelzését