Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Unaprijed plaćeni krediti

Lekcija 8 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. xAI model unaprijed plaćenih kredita
  2. Provjera stanja
  3. Kupnja kredita (dopuna)
  4. Strategije korištenja kredita
  5. Praćenje stanja
  6. Ključne točke

xAI model unaprijed plaćenih kredita

Unaprijed plaćeni krediti omogućuju ti kupnju stanja unaprijed, koje se troši kako vršiš API pozive. Ovaj je model idealan za kontrolu troškova: trošiš samo ono što si kupio, bez iznenađenja na kraju mjeseca. Krediti se koriste prije mjesečnog obračuna.

Provjera stanja

Unaprijed plaćeni model mijenja odnos rizika u usporedbi s mjesečnim obračunom. Kod naknadnog plaćanja iznos saznaješ na kraju; kod unaprijed plaćenog modela gornja granica postavljena je unaprijed, a najgori scenarij je prekid usluge – neugodno, ali ograničeno. Za tim koji istražuje API ili projekt s fiksnim proračunom, ovo je ispravan kompromis.

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

Odgovor sadrži:

  • Trenutno stanje u dolarima
  • Povijest dopuna s datumima i iznosima
  • Povijest korištenja po razdobljima

Kupnja kredita (dopuna)

Za ponovno punjenje stanja kredita:

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

Važne napomene o kreditima

Četiri točke u nastavku imaju konkretne posljedice na način na koji automatiziraš procese. Druga je posebno važna: krediti se ne mogu vratiti. To samo po sebi isključuje strategiju jedne velike kupnje „za svaki slučaj“ – skromne, česte dopune su bolje, čak i ako ih automatiziraš, od kapitala vezanog u projektu koji bi mogao promijeniti smjer.

  • Krediti se naplaćuju odmah pri kupnji na tvoju zadanu metodu plaćanja
  • Unaprijed plaćeni krediti su nepovratni (osim ako zakon u tvojoj jurisdikciji ne nalaže drugačije)
  • Krediti se troše prioritetno prije mjesečnog naknadnog obračuna
  • Nema navedenog datuma isteka za kredite – ostaju dostupni dok se ne potroše

Tijek naplaćivanja s kreditima

Vrijedi znati redoslijed potrošnje prije konfiguracije bilo čega, jer to određuje što prikazuju tvoje nadzorne ploče. Krediti idu prvi, mjesečni obračun preuzima nakon toga: drugim riječima, ako stanje unaprijed plaćenih sredstava stagnira na nuli dok sve radi, to znači da si već prešao na naknadno plaćanje, a da nisi ni shvatio.

  1. Dostupni unaprijed plaćeni krediti: tokeni se odbijaju od unaprijed plaćenog stanja
  2. Krediti potrošeni: potrošnja prelazi na mjesečni obračun (naknadno plaćanje)
  3. Dostignut limit potrošnje: zahtjevi se odbijaju

Strategije korištenja kredita

Fiksni mjesečni proračun

Ovo je strategija strogog proračuna: bez omogućenog mjesečnog obračuna, potrošnja kredita zaustavlja pozive umjesto generiranja duga. Prihvati kompromis – usluga se prekida, i bolje je da to bude eksplicitan izbor nego otkriće petkom navečer. Kombiniraj to s upozorenjem o niskom stanju opisanim kasnije.

import requests
from datetime import datetime

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

# Provjera stanja
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)

# Dopuna ako je stanje nisko
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"Dopunjeno ${top_up_amount:.2f}")

Opskrba projekta

Opskrba projekta ima prednost osim računovodstvene: stanje postaje mjera napretka. Ako je potrošena polovica kredita dok je obavljena samo četvrtina posla, tu informaciju dobivaš prije kraja, kada još imaš vremena odlučiti hoćeš li smanjiti opseg ili promijeniti modele.

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

Zatim prati korištenje putem analitike (sljedeća lekcija) kako bi osigurao poštivanje proračuna.

Praćenje stanja

Upozorenje o niskom stanju

#!/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 "UPOZORENJE: nisko stanje unaprijed plaćenih kredita ($BALANCE $)"
    # Pošalji obavijest
fi

Nadzorna ploča korištenja

Kombiniraj stanje unaprijed plaćenih kredita s pregledom naknadnih troškova za potpun uvid u svoje troškove:

# Stanje unaprijed plaćenih kredita
echo "=== Unaprijed plaćeni krediti ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Trenutni naknadni troškovi
echo "=== Naknadni troškovi ==="
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 točke

  • GET /v1/billing/teams/{teamId}/prepaid/balance vraća stanje i povijest
  • POST /v1/billing/teams/{teamId}/prepaid/top-up kupuje kredite (naplaćuje se odmah)
  • Unaprijed plaćeni krediti su nepovratni
  • Krediti se troše prije mjesečnog obračuna
  • Automatiziraj dopune s minimalnim pragom kako bi izbjegao prekide
  • Kombiniraj unaprijed plaćene kredite i limite potrošnje za potpunu kontrolu troškova