Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Predplačniški krediti

Lekcija 8 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Predplačniški model xAI
  2. Preveri svoje stanje
  3. Nakup kreditov (polog)
  4. Strategije uporabe kreditov
  5. Spremljanje stanja
  6. Ključne ugotovitve

Predplačniški model xAI

Predplačniški krediti ti omogočajo vnaprejšnji nakup stanja, ki se porablja ob klicih API-ja. Ta model je idealen za nadzor stroškov: porabiš le to, kar si kupil, brez neprijetnih presenečenj ob koncu meseca. Krediti se porabijo pred mesečnim obračunom.

Preveri svoje stanje

Predplačilo obrne razmerje tveganja v primerjavi z mesečnim obračunom. Pri plačilu po opravljeni storitvi znesek izveš šele na koncu; pri predplačilu je zgornja meja določena vnaprej, najslabši scenarij pa je prekinitev storitve – neprijetno, a omejeno. Za ekipo, ki raziskuje API, ali projekt s fiksnim proračunom je to pravi kompromis.

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

Odgovor vsebuje:

  • Trenutno stanje v dolarjih
  • Zgodovino pologov z datumi in zneski
  • Zgodovino porabe po obdobjih

Nakup kreditov (polog)

Za ponovno polnjenje stanja kreditov:

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

Pomembne točke glede kreditov

Spodnje štiri točke imajo konkretne posledice za tvojo avtomatizacijo. Še posebej druga: krediti niso vračljivi. To samo po sebi izključuje strategijo enega samega velikega nakupa „za vsak slučaj”. Boljši so skromni, pogosti pologi, tudi če jih avtomatiziraš, kot kapital, vezan v projektu, ki bi lahko spremenil smer.

  • Krediti se zaračunajo takoj ob nakupu na tvojo privzeto plačilno metodo
  • Predplačniški krediti so nevračljivi (razen če to zahteva zakonodaja v tvoji jurisdikciji)
  • Krediti se porabijo prednostno pred mesečnim obračunom po opravljeni storitvi
  • Za kredite ni navedenega datuma poteka – na voljo so, dokler se ne porabijo

Potek obračuna s krediti

Pred konfiguracijo je vredno poznati vrstni red porabe, saj ta določa, kaj prikazujejo tvoje nadzorne plošče. Najprej gredo krediti, nato prevzame mesečni obračun: z drugimi besedami, če predplačniško stanje stagnira na ničli, medtem ko vse deluje, pomeni, da si že preklopil na obračun po opravljeni storitvi, ne da bi se tega zavedal.

  1. Razpoložljivi predplačniški krediti: žetoni se odštejejo od predplačniškega stanja
  2. Porabljeni krediti: poraba se preklopi na mesečni obračun (po opravljeni storitvi)
  3. Dosežena omejitev porabe: zahteve so zavrnjene

Strategije uporabe kreditov

Fiksni mesečni proračun

To je strategija trdega proračuna: brez vklopljenega mesečnega obračuna poraba kreditov ustavi klice namesto ustvarjanja dolga. Sprejmi kompromis – storitev se prekine, bolje pa je, da je to izrecna izbira, kot pa odkritje v petek zvečer. Združi to z opozorilom za nizko stanje, opisanim kasneje.

import requests
from datetime import datetime

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

# Preveri stanje
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)

# Ponovno napolni, če je stanje nizko
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"Recharged ${top_up_amount:.2f}")

Opremljanje projekta

Opremljanje projekta ima poleg računovodske prednosti še eno: stanje postane merilo napredka. Če je porabljena polovica kreditov, opravljeno pa le četrtino dela, to izveš pred koncem, ko je še čas za odločitev o zmanjšanju obsega ali zamenjavi modelov.

# Proračun projekta: 500 $ v 3 mesecih
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}'

Nato spremljaj porabo prek analitike (naslednja lekcija), da zagotoviš spoštovanje proračuna.

Spremljanje stanja

Opozorilo za nizko stanje

#!/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: low prepaid balance ($BALANCE $)"
    # Pošlji obvestilo
fi

Nadzorna plošča za porabo

Združi predplačniško stanje s predogledom obremenitev po opravljeni storitvi za popoln pregled svojih stroškov:

# Predplačniško stanje
echo "=== Prepaid Credits ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Trenutne obremenitve po opravljeni storitvi
echo "=== Postpaid Charges ==="
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

Ključne ugotovitve

  • GET /v1/billing/teams/{teamId}/prepaid/balance vrne stanje in zgodovino
  • POST /v1/billing/teams/{teamId}/prepaid/top-up kupi kredite (zaračunano takoj)
  • Predplačniški krediti so nevračljivi
  • Krediti se porabijo pred mesečnim obračunom
  • Avtomatiziraj pologe z minimalnim pragom, da se izogneš prekinitev
  • Združi predplačniške kredite in omejitve porabe za popoln nadzor stroškov