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

Előre fizetett kreditek

8. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Az xAI előre fizetett modellje
  2. Egyenleg ellenőrzése
  3. Kreditek vásárlása (feltöltés)
  4. Kreditfelhasználási stratégiák
  5. Egyenlegfigyelés
  6. Főbb megállapítások

Az xAI előre fizetett modellje

Az előre fizetett kreditek lehetővé teszik, hogy előre megvásárolj egy egyenleget, amelyet az API-hívások során használsz fel. Ez a modell ideális a költségek kontrollálására: csak annyit költesz, amennyit vettél, így a hónap végén nem érhetnek meglepetések. A rendszer a krediteket a havi számlázás előtt használja fel.

Egyenleg ellenőrzése

Az előre fizetett modell megfordítja a kockázati viszonyt a havi számlázáshoz képest. Utólagos fizetés esetén csak a hónap végén tudod meg az összeget; előre fizetésnél viszont a limitet előre meghatározod, és a legrosszabb eset is csupán a szolgáltatás megszakadása – kellemetlen, de behatárolt. Egy API-t vizsgáló csapat vagy fix költségvetésű projekt esetén ez a megfelelő kompromisszum.

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

A válasz a következőket tartalmazza:

  • Az aktuális egyenleg dollárban
  • A feltöltési előzmények dátumokkal és összegekkel
  • A felhasználási előzmények időszakok szerint

Kreditek vásárlása (feltöltés)

A kredit-egyenleged feltöltéséhez:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

Fontos tudnivalók a kreditekről

Az alábbi négy pont konkrét következményekkel jár az automatizálásodra nézve. Különösen a második: a kreditek nem téríthetők vissza. Ez önmagában kizárja azt a stratégiát, hogy biztonsági okokból egyetlen nagy összegű vásárlást eszközölj. Jobb megoldás a szerényebb, gyakori feltöltés – még akkor is, ha ezeket automatizálod –, mintsem hogy tőkét köss le egy olyan projektben, amelynek az iránya megváltozhat.

  • A kreditek vásárláskor azonnal terhelődnek az alapértelmezett fizetési módodon
  • Az előre fizetett kreditek nem téríthetők vissza (kivéve, ha a joghatóságod ezt törvényileg előírja)
  • A kreditek felhasználása elsőbbséget élvez a havi utólagos számlázással szemben
  • A kreditek lejárati dátuma nincs meghatározva – addig maradnak elérhetők, amíg fel nem használod őket

Számlázási folyamat kreditekkel

Érdemes ismerned a felhasználási sorrendet bármilyen konfigurálás előtt, mivel ez határozza meg, mit látsz az egyes irányítópultjaidon. Először a kreditek fogynek, majd ezután lép életbe a havi számlázás: más szóval, ha egy előre fizetett egyenleg nullán stagnál, miközben minden működik, az azt jelenti, hogy észrevétlenül átváltottál az utólagos fizetésre.

  1. Előre fizetett kreditek elérhetők: a tokenek levonása az előre fizetett egyenlegből történik
  2. Kreditek kimerültek: a fogyasztás átvált a havi számlázásra (utólagos fizetés)
  3. Költési limit elérve: a kérések elutasításra kerülnek

Kreditfelhasználási stratégiák

Fix havi költségvetés

Ez a szigorú költségvetési stratégia: ha a havi számlázás nincs engedélyezve, a kreditek kimerülése leállítja a hívásokat ahelyett, hogy tartozást generálna. Vállald be ezt a kompromisszumot – a szolgáltatás megszakad, és jobb, ha ez egy tudatos döntés eredménye, mintsem egy péntek esti meglepetés. Kombináld ezt a később tárgyalt alacsony egyenlegre figyelmeztető rendszerrel.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Egyenleg ellenőrzése
balance_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
balance = balance_resp.json().get("balance", 0)

# Feltöltés, ha az egyenleg alacsony
MONTHLY_BUDGET = 200.00
RECHARGE_THRESHOLD = 50.00

if balance < RECHARGE_THRESHOLD:
    top_up_amount = MONTHLY_BUDGET - balance
    requests.post(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/top-up",
        headers={
            "Authorization": f"Bearer {MGMT_KEY}",
            "Content-Type": application/json"
        },
        json={"amount": top_up_amount}
    )
    print(f"Feltöltve: ${top_up_amount:.2f}")

Projekt előkészítése

A projekt előkészítésének (provisioning) van egy előnye a könyvelésen túl: az egyenleg a haladás mérőszámává válik. Ha a kreditek felét már felhasználtad, miközben a munka csak negyedét végezted el, időben értesülsz róla – még mielőtt vége lenne –, így van időd dönteni a hatókör csökkentéséről vagy a modellek váltásáról.

# Projekt költségvetés: 500 USD 3 hónapra
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500.00}'

Ezután kövesd nyomon a felhasználást az analitikai eszközökkel (következő lecke), hogy biztosítsd a költségvetés betartását.

Egyenlegfigyelés

Alacsony egyenlegre figyelmeztetés

#!/bin/bash
BALANCE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('balance', 0))")

THRESHOLD=20.00
if (( $(echo "$BALANCE < $THRESHOLD" | bc -l) )); then
    echo "FIGYELMEZTETÉS: alacsony előre fizetett egyenleg ($BALANCE $)"
    # Értesítés küldése
fi

Felhasználási irányítópult

Kombináld az előre fizetett egyleget az utólagos számlázás előzetes becslésével, hogy teljes képet kapj a költségeidről:

# Előre fizetett egyenleg
echo "=== Előre fizetett kreditek ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Jelenlegi utólagos terhelések
echo "=== Utólagos terhelések ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Főbb megállapítások

  • A GET /v1/billing/teams/{teamId}/prepaid/balance lekérdezés visszaadja az egyenleget és az előzményeket
  • A POST /v1/billing/teams/{teamId}/prepaid/top-up krediteket vásárol (azonnali terheléssel)
  • Az előre fizetett kreditek nem téríthetők vissza
  • A kreditek felhasználása a havi számlázás előtt történik
  • Automatizáld a feltöltéseket egy minimális küszöbérték beállításával a megszakítások elkerülése érdekében
  • Kombináld az előre fizetett krediteket a költési limitekkel a teljes költségszabályozás érdekében