Kredyty przedpłacone
Na tej stronie
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.
- Dostępne kredyty przedpłacone: tokeny są odejmowane od salda przedpłaconego
- Wyczerpanie kredytów: konsumpcja przełącza się na rozliczenie miesięczne (postpaid)
- 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/balancezwraca saldo i historięPOST /v1/billing/teams/{teamId}/prepaid/top-upkupuje 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