Przejdź do głównej treści
Polski— Wybierz język
Menu

Kredyty przedpłacone

Lekcja 8 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Model przedpłacony xAI
  2. Sprawdzanie salda
  3. Zakup kredytów (doładowanie)
  4. Przepływ rozliczeń z kredytami
  5. Strategie wykorzystania kredytów
  6. Monitorowanie salda
  7. Kluczowe wnioski

Model przedpłacony xAI

Kredyty przedpłacone pozwalają Ci zakupić saldo z góry, które jest zużywane w miarę wykonywania wywołań API. Model ten jest idealny do kontrolowania wydatków: płacisz tylko za to, co kupiłeś, bez niespodzianek na koniec miesiąca. Kredyty są wykorzystywane przed rozliczeniem miesięcznym.

Sprawdzanie salda

Przedpłata odwraca relację ryzyka w porównaniu do rozliczeń miesięcznych. W modelu płatnym z dołu kwotę poznajesz na koniec okresu; przy przedpłacie limit jest ustalony z góry, a najgorszym scenariuszem jest przerwa w działaniu usługi – nieprzyjemna, ale ograniczona. Dla zespołu badającego API lub projektu o stałym budżecie jest to właściwy kompromis.

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

Odpowiedź zawiera:

  • Bieżące saldo w dolarach
  • Historię doładowań z datami i kwotami
  • Historię użycia w podziale na okresy

Zakup kredytów (doładowanie)

Aby zasilić saldo kredytów:

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

Ważne informacje dotyczące kredytów

Cztery poniższe punkty mają konkretne konsekwencje dla sposobu, w jaki automatyzujesz procesy. Drugi z nich jest szczególnie istotny: kredyty nie podlegają zwrotowi. To samo w sobie wyklucza strategię dokonywania pojedynczego, dużego zakupu „na wszelki wypadek“. Skromne, częste doładowania są lepsze – nawet jeśli je zautomatyzujesz – niż kapitał zamrożony w projekcie, który może zmienić kierunek.

  • Kredyty są obciążane natychmiast w momencie zakupu na Twojej domyślnej metodzie płatności
  • Kredyty przedpłacone są bezzwrotne (chyba że prawo w Twojej jurysdykcji stanowi inaczej)
  • Kredyty są zużywane w pierwszej kolejności przed miesięcznym rozliczeniem z dołu (postpaid)
  • Dla kredytów nie podano daty ważności – pozostają dostępne do momentu ich zużycia

Przepływ rozliczeń z kredytami

Warto znać kolejność konsumpcji przed skonfigurowaniem czegokolwiek, ponieważ determinuje ona, co pokazują Twoje pulpity nawigacyjne. Kredyty idą pierwsze, rozliczenie miesięczne przejmuje kontrolę afterward: innymi słowy, saldo przedpłacone stagnujące na zerze, podczas gdy wszystko działa, oznacza, że już przełączyłeś się na model postpaid, nie zdając sobie z tego sprawy.

  1. Dostępne kredyty przedpłacone: tokeny są odejmowane od salda przedpłaconego
  2. Wyczerpanie kredytów: konsumpcja przełącza się na rozliczenie miesięczne (postpaid)
  3. Osiągnięcie limitu wydatków: żądania są odrzucane

Strategie wykorzystania kredytów

Stały budżet miesięczny

To strategia sztywnego budżetu: bez włączonego rozliczenia miesięcznego, wyczerpanie kredytów zatrzymuje wywołania zamiast generować dług. Zaakceptuj ten kompromis – usługa zostaje przerwana i lepiej, aby było to wynikiem świadomej decyzji, niż odkryciem w piątkowy wieczór. Połącz to z alertem niskiego salda opisanym później.

import requests
from datetime import datetime

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

# Sprawdź saldo
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)

# Doładuj, jeśli saldo jest niskie
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"Doładowano ${top_up_amount:.2f}")

Przydzielanie zasobów na projekt

Przydzielanie zasobów na projekt ma zaletę wykraczającą poza księgowość: saldo staje się miarą postępu. Jeśli połowa kredytów została zużyta, gdy wykonano tylko ćwierć pracy, otrzymujesz tę informację przed końcem, gdy jest jeszcze czas, by zdecydować, czy zmniejszyć zakres prac, czy zmienić modele.

# Budżet projektu: 500 $ przez 3 miesią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}'

Następnie monitoruj użycie za pomocą analityki (następna lekcja), aby upewnić się, że budżet jest przestrzegany.

Monitorowanie salda

Alert niskiego salda

#!/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: niskie saldo przedpłacone ($BALANCE $)"
    # Wyślij powiadomienie
fi

Panel użycia

Połącz saldo przedpłacone z podglądem obciążeń postpaid, aby uzyskać pełny obraz swoich kosztów:

# Saldo przedpłacone
echo "=== Kredyty przedpłacone ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Bieżące obciążenia postpaid
echo "=== Obciążenia Postpaid ==="
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

Kluczowe wnioski

  • GET /v1/billing/teams/{teamId}/prepaid/balance zwraca saldo i historię
  • POST /v1/billing/teams/{teamId}/prepaid/top-up kupuje kredyty (obciążenie natychmiastowe)
  • Kredyty przedpłacone są bezzwrotne
  • Kredyty są zużywane przed rozliczeniem miesięcznym
  • Automatyzuj doładowania z ustawionym progiem minimalnym, aby uniknąć przerw
  • Połącz kredyty przedpłacone z limitami wydatków dla całkowitej kontroli kosztów