Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Predplatené kredity

Lekcia 8 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Model predplatených kreditov xAI
  2. Kontrola zostatku
  3. Nákup kreditov (dobitie)
  4. Stratégie využívania kreditov
  5. Monitorovanie zostatku
  6. Kľúčové poznatky

Model predplatených kreditov xAI

Predplatené kredity ti umožňujú nakúpiť si zostatok vopred, ktorý sa spotrebúva pri volaniach API. Tento model je ideálny na kontrolu výdavkov: míňaš len to, čo si kúpil, bez nepríjemných prekvapení na konci mesiaca. Kredity sa využívajú pred mesačnou fakturáciou.

Kontrola zostatku

Predplatený model obracia vzťah rizika v porovnaní s mesačnou fakturáciou. Pri platbe po spotrebe zistíš sumu až na konci; pri predplatenej forme je strop stanovený vopred a najhorším scenárom je prerušenie služby – nepríjemné, ale ohraničené. Pre tím, ktorý skúma API, alebo projekt s fixným rozpočtom je to správny kompromis.

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

Odpoveď obsahuje:

  • Aktuálny zostatok v dolároch
  • Históriu dobíjaní s dátumami a sumami
  • Históriu využitia podľa období

Nákup kreditov (dobitie)

Na dobitie kreditného zostatku:

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

Dôležité body týkajúce sa kreditov

Štyri body nižšie majú konkrétne dôsledky pre spôsob, akým automatizuješ procesy. Druhý bod je obzvlášť dôležitý: kredity nie je možné vrátiť. To samo o sebe vylučuje stratégiu jednorazového veľkého nákupu „pre istotu“ – skromnejšie a častejšie dobíjania sú lepšie, aj keď ich automatizuješ, než kapitál viazaný v projekte, ktorý môže zmeniť smer.

  • Kredity sa účtujú okamžite pri nákupe na tvoju predvolenú platobnú metódu
  • Predplatené kredity nie je možné vrátiť (pokiaľ to nevyžaduje zákon v tvojej jurisdikcii)
  • Kredity sa spotrebúvajú prednostne pred mesačnou fakturáciou po spotrebe
  • Pre kredity nie je uvedený žiadny dátum exspirácie – zostávajú dostupné, kým sa nespotrebujú

Tok fakturácie s kreditmi

Stojí za to poznať poradie spotreby pred konfiguráciou čohokoľvek, pretože určuje, čo zobrazujú tvoje dashboardy. Kredity idú ako prvé, mesačná fakturácia preberá kontrolu až afterward: inými slovami, predplatený zostatok stagnujúci na nule, zatiaľ čo všetko funguje, znamená, že si už prešiel na fakturáciu po spotrebe, aniž by si si to uvedomil.

  1. Dostupné predplatené kredity: tokeny sa odpočítavajú z predplateného zostatku
  2. Vyčerpané kredity: spotreba sa prepne na mesačnú fakturáciu (po spotrebe)
  3. Dosiahnutý limit výdavkov: požiadavky sú odmietnuté

Stratégie využívania kreditov

Fixný mesačný rozpočet

Toto je stratégia tvrdého rozpočtu: bez povolenej mesačnej fakturácie vyčerpanie kreditov zastaví volania namiesto generovania dlhu. Akceptuj kompromis – služba sa preruší a je lepšie, ak je to explicitná voľba, než objav v piatok večer. Skombinuj to s alertom na nízky zostatok, ktorý je opísaný nižšie.

import requests
from datetime import datetime

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

# Kontrola zostatku
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)

# Dobitie, ak je zostatok nízky
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"Dobité ${top_up_amount:.2f}")

Provisioning projektu

Provisioning projektu má výhodu nielen v účtovníctve: zostatok sa stáva mierou pokroku. Ak je spotrebovaná polovica kreditov, zatiaľ čo hotová je len štvrtina práce, získavaš túto informáciu skôr, než je neskoro, keď je ešte čas rozhodnúť sa, či obmedziť rozsah alebo prepnúť modely.

# Rozpočet projektu: 500 $ na 3 mesiace
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}'

Následne monitoruj využitie prostredníctvom analytiky (ďalšia lekcia), aby si zabezpečil dodržanie rozpočtu.

Monitorovanie zostatku

Alert na nízky zostatok

#!/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 "ALERT: nízky predplatený zostatok ($BALANCE $)"
    # Odoslať notifikáciu
fi

Dashboard využitia

Skombinuj predplatený zostatok s náhľadom na poplatky po spotrebe, aby si získal kompletný prehľad o svojich nákladoch:

# Predplatený zostatok
echo "=== Predplatené kredity ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Aktuálne poplatky po spotrebe
echo "=== Poplatky po spotrebe ==="
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

Kľúčové poznatky

  • GET /v1/billing/teams/{teamId}/prepaid/balance vracia zostatok a históriu
  • POST /v1/billing/teams/{teamId}/prepaid/top-up kupuje kredity (účtované okamžite)
  • Predplatené kredity nie je možné vrátiť
  • Kredity sa spotrebúvajú pred mesačnou fakturáciou
  • Automatizuj dobíjanie s minimálnym prahom, aby si predišiel prerušeniam
  • Skombinuj predplatené kredity a limity výdavkov pre totálnu kontrolu nákladov