Saldo ja automaatsed üleslaadimised
Sellel lehel
Jälgi ja automatiseeri üleslaadimisi
Ettemakstud saldo jälgimise kombineerimine kasutusanalüütikaga võimaldab sul seadistada nutika üleslaadimissüsteemi. Manuaalse üleslaadimise asemel saad protsessi automatiseerida, lähtudes lävenditest ja tarbimise prognoosidest.
Kontrolli saldo üksikasju
See lõpp-punkt tagastab kaks elementi, mida ei tohi omavahel segi ajada: kohene saldo ja tehingute ajalugu. Esimene vastab küsimusele „Kas saan API-d veel kasutada?“, teine küsimusele „Kui kiiresti ma tarbin?“. Just teine võimaldab ennustada ja seetõttu on see ainus, millele saad automatiseerimise rajada.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastus sisaldab jooksvat saldot ja tehingute ajalugu (ostud ja tarbimine).
Automaatne üleslaadimissüsteem
Hästi konfigureeritud automaatne üleslaadimine tugineb kahele numbrile, millest üks sageli unustatakse. Käivitamise lävend peab katma sinu tarbimise reaktsiooniaja jooksul: kui kontrollid kord päevas, vajad vähemalt ühe päeva jagu krediiti ette, vastasel juhul käivitub automatiseerimine alles pärast piiri ületamist. Kuu ülempiir on kaitsemeede, mida kõige sagedamini ei määrata – ilma selleta võib rakenduses olev vigane tsükkel käivitada üleslaadimise järel teise ja xAI krediidid ei ole tagastatavad.
Neid kahte väärtust ei määrata suvaliselt: järgmises osas näitame, kuidas neid arvutada sinu tegeliku tarbimise põhjal.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Konfiguratsioon
MIN_BALANCE = 50.00 # Üleslaadimise lävend
TOP_UP_AMOUNT = 200.00 # Üleslaadimise summa
MAX_MONTHLY = 1000.00 # Kuu ülempiir
def get_balance():
"""Hangi jooksev ettemakstud saldo."""
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():
"""Arvuta käimasoleva kuu üleslaadimiste kogusumma."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtreeri tehingud käimasoleva kuu jaoks
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):
"""Teosta üleslaadimine."""
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
# Üleslaadimise loogika
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"Üleslaadimine ${TOP_UP_AMOUNT:.2f}. Hinnanguline uus saldo: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Viga üleslaadimisel")
else:
print(f"Kuu ülempiir saavutatud (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Piisav saldo: ${balance:.2f}")
Tarbimise prognoosimine
Prognoosimine muudab jälgimise ennetamiseks. Enamiku kasutusjuhtude piisab seitsme päeva keskmisest; see annab sulle ammendumiskuupäeva, nii et sul on aega tegutseda. Olge aga ettevaatlik oma liikluse hooajalisuse suhtes – aeglase nädala põhjal arvutatud keskmine lubab autonoomiat, mis kaob niipea, kui liiklus suureneb.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Tarbimine viimase 7 päeva jooksul
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"}]
}
}
)
# Arvuta päevane keskmine
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
# Hinda järelejäänud päevi
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"Keskmine tarbimine: ${avg_daily_cost:.2f}/päev")
print(f"Jooksev saldo: ${current_balance:.2f}")
print(f"Hinnanguline ammendumine: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} päeva)")
Integreeritud jälgimise armatuurlaud
Armatuurlaud toob kokku info, mida sinu kulude kohta teavad kolm erinevat lõpp-punkti: ettemakstud saldo, kuu arve tasud ja konfigureeritud piirangud. Eraldi võetuna räägib üksik element poolikut lugu – mugav saldo ei ütle midagi paralleelselt toimuva järelmaksuga tarbimise kohta. Just nende andmete kooskõlastamine annab tegeliku kulu käimasoleva kuu kohta.
#!/bin/bash
echo "=== xAI Armatuurlaud - $(date '+%m/%d/%Y %H:%M') ==="
# Ettemakstud saldo
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 "Ettemakstud saldo: \$${BALANCE}"
# Järelmaksu tasud
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 "Järelmaksu tasud: \$${POSTPAID}"
# Kulutuste limiit
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 "Kuu limiit: \$${LIMIT}"
Peamised punktid
- Automatiseeri üleslaadimised, kasutades miinimumlävendit ja kuu ülempiiri
- Kasuta analüütikat krediidi ammendumiskuupäevade prognoosimiseks
- Ühenda ettemakstud saldo, järelmaksu tasud ja limiidid ühtsesse armatuurlauda
- Krediidid ei ole tagastatavad – kalibreeri automaatsed üleslaadimised ettevaatlikult
- Integreeri need skriptid oma croni või CI/CD torustikku