Számlázási információk
Ezen az oldalon
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.
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ésPOSTmódszereket a/v1/billing/teams/{teamId}/billing-infové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