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

Баланс и автоматично зареждане

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

Мониторинг и автоматизация на зареждането

Комбинирането на проследяването на предплатения баланс с анализ на използването Ви позволява да настроите интелигентна система за автоматично зареждане. Вместо да зареждате ръчно, можете да автоматизирате процеса въз основа на прагове и прогнози за потреблението.

Проверка на детайлите за баланса

Крайната точка връща две неща, които не бива да бъркате: моментния баланс и историята на транзакциите. Първият отговаря на въпроса „Мога ли все още да извиквам API?“, а вторият – „С каква скорост консумирам?“. Вторият е този, който Ви позволява да предвидите бъдещото състояние и следователно е единственият, върху който можете да базирате автоматизацията.

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

Отговорът съдържа текущия баланс и историята на транзакциите (покупки и потребление).

Система за автоматично зареждане

Една добре конфигурирана система за автоматично зареждане разчита на две числа, като едното от тях често се забравя. Прагът за задействане трябва да покрива Вашето потребление през времето за реакция: ако проверявате веднъж дневно, Ви е необходим кредит поне за един ден предварително, в противен случай автоматизацията ще се задейства след изчерпването на средствата. Месечният лимит е защитният механизъм, който най-често липсва – без него дефектен цикъл във Вашето приложение може да задейства зареждане след зареждане, а кредитите на xAI не подлежат на възстановяване.

Тези две стойности не се задават произволно: следващата секция показва как да ги изчислите въз основа на реалното Ви потребление.

import requests
from datetime import datetime, timedelta

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

# Configuration
MIN_BALANCE = 50.00      # Top-up threshold
TOP_UP_AMOUNT = 200.00   # Top-up amount
MAX_MONTHLY = 1000.00    # Monthly cap

def get_balance():
    """Get the current prepaid balance."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    return resp.json().get("balance", 0)

def get_monthly_top_ups():
    """Calculate the total top-ups for the current month."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Filter transactions for the current month
    transactions = resp.json().get("transactions", [])
    current_month = datetime.now().strftime("%Y-%m")
    monthly_total = sum(
        t.get("amount", 0)
        for t in transactions
        if t.get("type") == "top-up" and t.get("date", "").startswith(current_month)
    )
    return monthly_total

def top_up(amount):
    """Perform a top-up."""
    resp = 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": amount}
    )
    return resp.status_code == 200

# Top-up logic
balance = get_balance()
monthly_spent = get_monthly_top_ups()

if balance < MIN_BALANCE:
    remaining_budget = MAX_MONTHLY - monthly_spent
    if remaining_budget >= TOP_UP_AMOUNT:
        if top_up(TOP_UP_AMOUNT):
            print(f"Top-up of ${TOP_UP_AMOUNT:.2f}. Estimated new balance: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Error during top-up")
    else:
        print(f"Monthly cap reached (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Sufficient balance: ${balance:.2f}")

Прогнозиране на потреблението

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

import requests
from datetime import datetime, timedelta

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

# Consumption over the last 7 days
end = datetime.now()
start = end - timedelta(days=7)

usage_resp = requests.post(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/usage",
    headers={
        "Authorization": f"Bearer {MGMT_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "analyticsRequest": {
            "timeRange": {
                "startTime": start.strftime("%Y-%m-%d %H:%M:%S"),
                "endTime": end.strftime("%Y-%m-%d %H:%M:%S"),
                "timezone": "Europe/Paris"
            },
            "timeUnit": "DAY",
            "values": [{"name": "cost", "aggregation": "SUM"}]
        }
    }
)

# Calculate daily average
data_points = usage_resp.json().get("dataPoints", [])
daily_costs = [p.get("value", 0) for p in data_points]
avg_daily_cost = sum(daily_costs) / len(daily_costs) if daily_costs else 0

# Estimate remaining days
balance_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_balance = balance_resp.json().get("balance", 0)

if avg_daily_cost > 0:
    days_remaining = current_balance / avg_daily_cost
    exhaustion_date = datetime.now() + timedelta(days=days_remaining)
    print(f"Average consumption: ${avg_daily_cost:.2f}/day")
    print(f"Current balance: ${current_balance:.2f}")
    print(f"Estimated exhaustion: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} days)")

Интегриран табл за проследяване

Таблото обединява информацията за разходите Ви, която три различни крайни точки притежават: предплатения баланс, месечните фактурирани такси и конфигурираните лимити. Разделени, всяка от тях разказва непълна история – комфортният баланс не говори нищо за потреблението след плащане (postpaid), което тече успоредно. Именно съпоставянето дава истинската стойност на разходите за текущия месец.

#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="

# Prepaid balance
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', 'N/A'))")
echo "Prepaid balance: \$${BALANCE}"

# Postpaid charges
POSTPAID=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('totalAmount', 'N/A'))")
echo "Postpaid charges: \$${POSTPAID}"

# Spending limit
LIMIT=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('monthlyLimit', 'N/A'))")
echo "Monthly limit: \$${LIMIT}"

Ключови изводи

  • Автоматизирайте зареждането с минимален праг и месечен лимит
  • Използвайте аналитики, за да прогнозирате датите на изчерпване на кредита
  • Комбинирайте предплатения баланс, таксите след плащане и лимитите в единен табл
  • Кредитите не подлежат на възстановяване – калибрирайте автоматичните зареждания с внимание
  • Интегрирайте тези скриптове във Вашия cron или CI/CD pipeline