Předplacené kredity
Na této stránce
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.
- Dostupné předplacené kredity: tokeny se odečítají z předplaceného zůstatku
- Vyčerpané kredity: spotřeba přechází na měsíční fakturaci (postpaid)
- 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/balancevrací zůstatek a historiiPOST /v1/billing/teams/{teamId}/prepaid/top-upnakupuje 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ů