Премини към основното съдържание
Български— Изберете език
Меню

Предплатени кредити

Урок 8 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Предплатен модел на xAI
  2. Проверка на баланса
  3. Покупка на кредити (зареждане)
  4. Стратегии за използване на кредити
  5. Мониторинг на баланса
  6. Ключови изводи

Предплатен модел на 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)
  • Няма посочена дата на изтичане на валидността на кредитите – те остават налични, докато не бъдат изразходвани

Поток на таксуване с кредити

Струва си да знаете реда на потребление, преди да конфигурирате каквото и да е, тъй като това определя какво показват Вашите табла за управление. Първо се използват кредитите, след което влиза в сила месечното таксуване: с други думи, ако предплатеният баланс стои на нула, докато всичко работи, това означава, че вече сте преминали към таксуване след употреба, без да сте го осъзнали.

  1. Налични предплатени кредити: токените се удържат от предплатения баланс
  2. Изчерпани кредити: потреблението преминава към месечно таксуване (postpaid)
  3. Достигнат лимит на разходите: заявките се отхвърлят

Стратегии за използване на кредити

Фиксиран месечен бюджет

Това е стратегията за твърд бюджет: без активирано месечно таксуване, изчерпването на кредитите спира обажданията, вместо да генерира дълг. Приемете компромиса – услугата се прекъсва и е по-добре това да бъде изричен избор, отколкото неприятно откритие в петък вечер. Комбинирайте го с описаното по-късно предупреждение за нисък баланс.

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 закупува кредити (таксуват се незабавно)
  • Предплатените кредити не подлежат на възстановяване
  • Кредитите се изразходват преди месечното таксуване
  • Автоматизирайте зарежданията с минимален праг, за да избегнете прекъсвания
  • Комбинирайте предплатени кредити и лимити на разходите за пълен контрол на разходите