Лимити на разходите
На тази страница
Контрол на разходите за API
Лимитите на разходите са Вашата финансова предпазна мрежа. Те задават таван, след който заявките към API се отхвърлят, предотвратявайки неочаквани такси в края на месеца. Management API Ви позволява да преглеждате и задавате тези лимити програмно.
Преглед на текущите лимити
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Отговорът показва текущия таван на цикъла и Вашето текущо потребление – следователно, чрез изваждане, оставащия Ви марж. Това е единственото число, което има значение ежедневно: таван без данни за потреблението не Ви казва дали сте изразходвали 10% или 95% от бюджета си.
Задаване на лимити
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"monthlyLimit": 500.00
}'
Поведение при надвишаване
Ето успокояващата част и си заслужава да се каже изрично: достигането на лимита никога не води до начисляване на такси над тавана. Заявките се отхвърлят, а не се таксуват над лимита. Рискът се премества от финансов към наличност – което е точно това, което искате, защото прекъсването се диагностицира и отстранява за минути, докато неочаквана фактура се открива твърде късно.
Когато потреблението достигне зададения лимит:
- Заявките към API се отхвърлят със специфичен код за грешка
- API ключовете остават активни, но извикванията за инфериране се провалят
- Лимитът се нулира в началото на следващия цикъл на таксуване
Стратегия за лимити по среди
За екип с множество проекти лимитът трябва да отразява риска, специфичен за всяка среда. В разработката типичната опасност е случаен цикъл от заявки – тестов скрипт, работещ цяла нощ – и нисък лимит от 50 до 100 щатски долара превръща тази грешка в инцидент от 10 долара, вместо в изненада от 1000 долара. Staging средата обработва тестове за натоварване, които законно консумират повече: умерен лимит от 200 до 500 щатски долара оставя място за тестови кампании, като същевременно запазва предпазна ограда. Продукционната среда обаче никога не трябва да се ограничава до точка на отказване на клиентски заявки: по-висок лимит (1000 щатски долара и нагоре, в зависимост от трафика) идва с активно наблюдение – предупреждението Ви защитава, докато лимитът е просто предпазна мрежа за краен случай.
Преглед на текущите такси
За да видите къде се намирате в текущия цикъл:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Този крайна точка връща натрупаните такси от началото на цикъла. В сравнение с броя изминали дни, това Ви дава повече от моментна снимка: прогноза. Консумирането на 40% от бюджета при една трета от месеца е здравословно; същите 40% при една десета от месеца сигнализират за превишаване и все още имате двадесет и седем дни да действате.
Автоматизиране на наблюдението на разходите
Скрипт за предупреждение при праг
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Предупреждение при 80% от лимита
# Получаване на лимита
limits_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/spending-limits",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
monthly_limit = limits_resp.json().get("monthlyLimit", 0)
# Получаване на текущото потребление
preview_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/invoice/preview",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_spend = preview_resp.json().get("totalAmount", 0)
# Проверка на прага
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"ALERT: {ratio*100:.1f}% of limit reached")
print(f" Spend: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Изпращане на известие
Интеграция със системи за наблюдение
Комбинирайте прегледа на таксите с Вашето решение за наблюдение (Grafana, Datadog и др.), за да създадете табла за разходи в реално време:
# Получаване на текущата сума за изпращане към Вашата система за метрики
CURRENT_SPEND=$(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', 0))")
echo "xai.billing.current_spend:$CURRENT_SPEND|g" | nc -u -w1 localhost 8125
Динамично адаптиране на лимитите
Лимитът не е фиксиран за целия цикъл на таксуване – и това е добре, защото жизненият цикъл на продукта не следва счетоводния календар. Преди очакван скок в трафика, стартиране на продукт или маркетингова кампания, временно увеличете лимита: няма нищо по-лошо от платена кампания, която изпраща потребители към услуга, чийто API отказва заявки поради достигнат таван. Обратно, ако бюджетът за месеца вече се изразходва по-бързо от очакваното, намаляването на лимита за остатъка от цикъла превръща отклонението в контролирано ограничение. Най-критичният случай остава инцидент с разходите – цикъл в продукционна среда, открито злоупотреба: незабавното намаляване на лимита е Вашият бутон за аварийно спиране, този, който спира кървенето, докато откриете причината.
# Временно увеличаване за стартиране
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 2000.00}'
# Нулиране на нормалния лимит след скока
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 500.00}'
Ключови изводи
- Използвайте
GETиPOSTвърху/v1/billing/teams/{teamId}/postpaid/spending-limits, за да преглеждате и задавате лимити - Когато лимитът бъде надвишен, заявките към API се отхвърлят (без начисляване на такси над тавана)
- Прегледът на таксите (
invoice/preview) Ви позволява да следите потреблението в реално време - Автоматизирайте предупрежденията при прагове, за да предвидите превишавания
- Адаптирайте лимитите според средата (разработка, staging, продукция)