Предплатени кредити
На тази страница
Предплатен модел на xAI
Предплатените кредити Ви позволяват да закупите баланс предварително, който се изразходва при всяко Ваше обаждане към API. Този модел е идеален за контрол на разходите: плащате само за това, което сте закупили, без неприятни изненади в края на месеца. Кредитите се използват преди месечното таксуване.
Проверка на баланса
Предплащането обръща рисковата зависимост в сравнение с месечното таксуване. При плащане след употреба (postpaid) научавате сумата в края на периода; при предплащане лимитът се определя предварително, а най-лошият сценарий е прекъсване на услугата – неприятно, но ограничено. За екип, който изследва API, или за проект с фиксиран бюджет, това е правилният компромис.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Отговорът съдържа:
- Текущия баланс в щатски долари
- Историята на зарежданията с дати и суми
- Историята на използването по периоди
Покупка на кредити (зареждане)
За да заредите отново своя кредитен баланс:
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
}'
Важни бележки относно кредитите
Четирите точки по-долу имат конкретни последствия за начина, по който автоматизирате процесите. Втората точка е особено важна: кредитите не подлежат на възстановяване. Само този факт изключва стратегията за еднократна голяма покупка „за всеки случай“. По-добре е да правите скромни и чести зареждания, дори да ги автоматизирате, отколкото да държите капитал, замразен в проект, който може да промени посоката си.
- Кредитите се таксуват незабавно при покупка чрез Вашия метод на плащане по подразбиране
- Предплатените кредити не подлежат на възстановяване (освен ако законодателството във Вашата юрисдикция не изисква обратното)
- Кредитите се изразходват с приоритет преди месечното таксуване след употреба (postpaid)
- Няма посочена дата на изтичане на валидността на кредитите – те остават налични, докато не бъдат изразходвани
Поток на таксуване с кредити
Струва си да знаете реда на потребление, преди да конфигурирате каквото и да е, тъй като това определя какво показват Вашите табла за управление. Първо се използват кредитите, след което влиза в сила месечното таксуване: с други думи, ако предплатеният баланс стои на нула, докато всичко работи, това означава, че вече сте преминали към таксуване след употреба, без да сте го осъзнали.
- Налични предплатени кредити: токените се удържат от предплатения баланс
- Изчерпани кредити: потреблението преминава към месечно таксуване (postpaid)
- Достигнат лимит на разходите: заявките се отхвърлят
Стратегии за използване на кредити
Фиксиран месечен бюджет
Това е стратегията за твърд бюджет: без активирано месечно таксуване, изчерпването на кредитите спира обажданията, вместо да генерира дълг. Приемете компромиса – услугата се прекъсва и е по-добре това да бъде изричен избор, отколкото неприятно откритие в петък вечер. Комбинирайте го с описаното по-късно предупреждение за нисък баланс.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Проверка на баланса
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)
# Зареждане, ако балансът е нисък
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"Recharged ${top_up_amount:.2f}")
Осигуряване на ресурси за проект
Осигуряването на ресурси за проект има предимство извън счетоводството: балансът се превръща в мярка за напредъка. Ако половината от кредитите са изразходвани, докато е изпълнена само една четвърт от работата, получавате тази информация преди края, когато все още има време да решите дали да намалите обхвата или да смените моделите.
# Бюджет на проекта: 500 щ.д. за 3 месеца
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}'
След това следете използването чрез аналитики (следващия урок), за да гарантирате спазването на бюджета.
Мониторинг на баланса
Предупреждение за нисък баланс
#!/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: low prepaid balance ($BALANCE $)"
# Изпращане на известие
fi
Табло за използване
Комбинирайте предплатения баланс с прегледа на таксите след употреба (postpaid), за да получите пълна представа за Вашите разходи:
# Предплатен баланс
echo "=== Предплатени кредити ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Текущи такси след употреба
echo "=== Такси след употреба (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
Ключови изводи
GET /v1/billing/teams/{teamId}/prepaid/balanceвръща баланса и историятаPOST /v1/billing/teams/{teamId}/prepaid/top-upзакупува кредити (таксуват се незабавно)- Предплатените кредити не подлежат на възстановяване
- Кредитите се изразходват преди месечното таксуване
- Автоматизирайте зарежданията с минимален праг, за да избегнете прекъсвания
- Комбинирайте предплатени кредити и лимити на разходите за пълен контрол на разходите