Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Předplacené kredity

Lekce 8 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Předplacený model xAI
  2. Kontrola zůstatku
  3. Nákup kreditů (dobití)
  4. Strategie využívání kreditů
  5. Monitorování zůstatku
  6. Klíčové poznatky

Předplacený model xAI

Předplacené kredity ti umožní nakoupit si kreditní zůstatek předem, který se čerpá při volání API. Tento model je ideální pro kontrolu výdajů: utratíš pouze to, co jsi koupil, bez nepříjemných překvapení na konci měsíce. Kredity se spotřebovávají před měsíčním fakturačním cyklem.

Kontrola zůstatku

Předplacený systém obrací rizikový vztah oproti měsíční fakturaci. U platby zpětně (postpaid) zjistíš částku až na konci období; u předplaceného modelu je strop nastaven předem a nejhorším scénářem je přerušení služby – nepříjemné, ale ohraničené. Pro tým, který teprve zkoumá API, nebo pro projekt s pevným rozpočtem je to ta správná volba.

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

Odpověď obsahuje:

  • Aktuální zůstatek v dolarech
  • Historii dobíjení s daty a částkami
  • Historii využití rozdělenou podle období

Nákup kreditů (dobití)

Pro dobití kreditního zůstatku:

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ící se kreditů

Následující čtyři body mají konkrétní dopad na to, jak automatizuješ své procesy. Druhý bod je obzvlášť klíčový: kredity nelze vrátit. To samo o sobě vylučuje strategii jediného velkého nákupu „pro jistotu“. Lepší jsou menší, častější dobíjení, i když je automatizuješ, než vázat kapitál v projektu, který může změnit směr.

  • Kredity jsou účtovány okamžitě při nákupu na tvou výchozí platební metodu
  • Předplacené kredity jsou nevratné (pokud zákon v tvé jurisdikci nevyžaduje jinak)
  • Kredity se spotřebovávají přednostně před měsíční fakturací (postpaid)
  • U kreditů není uvedeno žádné datum expirace – zůstávají k dispozici, dokud nejsou spotřebovány

Fakturační tok s kredity

Stojí za to znát pořadí spotřeby ještě před jakoukoli konfigurací, protože určuje, co uvidíš na svých dashboardech. Kredity jdou první, měsíční fakturace přebírá otěže až poté: jinými slovy, pokud předplacený zůstatek stagnuje na nule a vše funguje, znamená to, že jsi již nepozorovaně přešel na režim postpaid.

  1. Dostupné předplacené kredity: tokeny se odečítají z předplaceného zůstatku
  2. Vyčerpané kredity: spotřeba přechází na měsíční fakturaci (postpaid)
  3. Dosažen limit útrat: požadavky jsou odmítnuty

Strategie využívání kreditů

Pevný měsíční rozpočet

Toto je strategie tvrdého rozpočtu: pokud není povolena měsíční fakturace, vyčerpání kreditů zastaví volání místo toho, aby generovalo dluh. Akceptuj tento kompromis – služba se přeruší, a je lepší, aby to bylo explicitní rozhodnutí, než objev v pátek večer. Zkombinuj to s upozorněním na nízký zůstatek, které je popsáno níže.

import requests
from datetime import datetime

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

# Kontrola zůstatku
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)

# Dobití při nízkém zůstatku
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"Dobito ${top_up_amount:.2f}")

Zásobování projektu

Zásobování projektu má výhodu nejen v účetnictví: zůstatek se stává měřítkem pokroku. Pokud je spotřebována polovina kreditů, zatímco hotova je jen čtvrtina práce, získáš tuto informaci včas, kdy je ještě prostor rozhodnout se pro snížení rozsahu nebo přepnutí modelů.

# Rozpočet projektu: 500 $ na 3 měsíce
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ásledně sleduj využití prostřednictvím analytiky (další lekce), abys zajistil dodržení rozpočtu.

Monitorování zůstatku

Upozornění na nízký zůstatek

#!/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 "UPOZORNĚNÍ: nízký předplacený zůstatek ($BALANCE $)"
    # Odeslat oznámení
fi

Dashboard využití

Zkombinuj předplacený zůstatek s náhledem na postpaid poplatky pro kompletní přehled o svých nákladech:

# Předplacený zůstatek
echo "=== Předplacené 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ální postpaid poplatky
echo "=== Postpaid poplatky ==="
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

Klíčové poznatky

  • GET /v1/billing/teams/{teamId}/prepaid/balance vrací zůstatek a historii
  • POST /v1/billing/teams/{teamId}/prepaid/top-up nakupuje kredity (účtováno okamžitě)
  • Předplacené kredity jsou nevratné
  • Kredity se spotřebovávají před měsíční fakturací
  • Automatizuj dobíjení s minimálním prahem, abys předešel přerušením
  • Zkombinuj předplacené kredity a limity útrat pro totální kontrolu nákladů