Υπόλοιπο και αυτόματες επαναφορτίσεις
Σε αυτήν τη σελίδα
Παρακολούθηση και αυτοματοποίηση επαναφορτίσεων
Ο συνδυασμός της παρακολούθησης του προπληρωμένου υπολοίπου με τα αναλυτικά στοιχεία χρήσης σάς επιτρέπει να στήσετε ένα έξυπνο σύστημα επαναφόρτισης. Αντί να κάνετε χειροκίνητες επαναφορτίσεις, μπορείτε να αυτοματοποιήσετε τη διαδικασία με βάση κατώφλια και προβλέψεις κατανάλωσης.
Έλεγχος λεπτομερειών υπολοίπου
Το endpoint επιστρέφει δύο στοιχεία που δεν πρέπει να συγχέετε: το άμεσο υπόλοιπο και το ιστορικό συναλλαγών. Το πρώτο απαντά στο «Μπορώ ακόμα να καλέσω το API;», ενώ το δεύτερο απαντά στο «Πόσο γρήγορα καταναλώνω;». Το δεύτερο είναι αυτό που σας επιτρέπει να κάνετε προβλέψεις και, κατά συνέπεια, το μόνο στο οποίο μπορείτε να βασίσετε την αυτοματοποίηση.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Η απόκριση περιέχει το τρέχον υπόλοιπο και το ιστορικό συναλλαγών (αγορές και κατανάλωση).
Σύστημα αυτόματης επαναφόρτισης
Ένα καλά διαμορφωμένο σύστημα αυτόματης επαναφόρτισης βασίζεται σε δύο αριθμούς, ένας από τους οποίους συχνά ξεχνιέται. Το κατώφλι ενεργοποίησης πρέπει να καλύπτει την κατανάλωσή σας κατά τον χρόνο αντίδρασης: αν ελέγχετε μία φορά την ημέρα, χρειάζεστε τουλάχιστον μία ημέρα πίστωσης εκ των προτέρων, διαφορετικά η αυτοματοποίηση θα ενεργοποιηθεί μετά την cutoff. Το μηνιαίο όριο είναι η δικλείδα ασφαλείας που συχνά λείπει—χωρίς αυτό, ένας ελαττωματικός βρόχος στην εφαρμογή σας μπορεί να προκαλέσει επαναφόρτιση μετά την επαναφόρτιση, και οι πιστώσεις 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}")
Πρόβλεψη κατανάλωσης
Η πρόβλεψη μετατρέπει την παρακολούθηση σε anticipation. Ένας μέσος όρος επτά ημερών αρκεί για τις περισσότερες περιπτώσεις χρήσης· σας δίνει μια ημερομηνία εξάντλησης, ώστε να έχετε χρόνο να αντιδράσετε. Προσοχή όμως στη δική σας εποχικότητα κίνησης—ένας μέσος όρος που υπολογίζεται κατά τη διάρκεια μιας ήσυχης εβδομάδας υπόσχεται αυτονομία που θα εξαφανιστεί μόλις αυξηθεί η κίνηση.
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)")
Ενοποιημένος πίνακας παρακολούθησης
Ο πίνακας ελέγχου συγκεντρώνει ό,τι γνωρίζουν τρία διαφορετικά endpoints σχετικά με το κόστος σας: το προπληρωμένο υπόλοιπο, τις μηνιαίες χρεώσεις λογαριασμού και τα διαμορφωμένα όρια. Ξεχωριστά, το καθένα αφηγείται μια ημιτελή ιστορία—ένα άνετο υπόλοιπο δεν λέει τίποτα για την 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}"
Βασικά σημεία
- Αυτοματοποιήστε τις επαναφορτίσεις με ένα ελάχιστο κατώφλι και ένα μηνιαίο όριο
- Χρησιμοποιήστε αναλυτικά στοιχεία για να προβλέψετε ημερομηνίες εξάντλησης πίστωσης
- Συνδυάστε το προπληρωμένο υπόλοιπο, τις postpaid χρεώσεις και τα όρια σε έναν ενοποιημένο πίνακα ελέγχου
- Οι πιστώσεις δεν επιστρέφονται—βαθμονομήστε τις αυτόματες επαναφορτίσεις με προσοχή
- Ενσωματώστε αυτά τα σενάρια στο cron ή στον αγωγό CI/CD σας