Credite preplătite
Pe această pagină
Modelul preplătit xAI
Creditele preplătite vă permit să achiziționați un sold în avans, care este consumat pe măsură ce efectuați apeluri API. Acest model este ideal pentru controlul cheltuielilor: cheltuiți doar suma achiziționată, fără surprize la sfârșitul lunii. Creditele sunt utilizate înainte de facturarea lunară.
Verificarea soldului
Preplătirea inversează relația de risc comparativ cu facturarea lunară. În cazul postplătit, descoperiți suma la sfârșit; în cazul preplătit, plafonul este stabilit în avans, iar cel mai defavorabil scenariu este întreruperea serviciului – neplăcut, dar limitat. Pentru o echipă care explorează API-ul sau un proiect cu un buget fix, acesta este compromisul corect.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Răspunsul conține:
- Soldul curent în dolari
- Istoricul reîncărcărilor cu date și sume
- Istoricul utilizării pe perioade
Achiziționarea de credite (reîncărcare)
Pentru a reîncărca soldul de credite:
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
}'
Aspecte importante privind creditele
Cele patru puncte de mai jos au consecințe concrete asupra modului în care automatizați procesele. Al doilea este crucial: creditele nu sunt rambursabile. Acest singur aspect elimină strategia unei achiziții unice de amploare „pentru siguranță“; reîncărcările modeste și frecvente sunt preferabile, chiar dacă le automatizați, decât capitalul blocat într-un proiect care își poate schimba direcția.
- Creditele sunt debitare imediat la achiziție de pe metoda de plată implicită
- Creditele preplătite nu sunt rambursabile (cu excepția cazurilor impuse legal în jurisdicția dumneavoastră)
- Creditele sunt consumate prioritar înainte de facturarea lunară postplătită
- Nu există o dată de expirare listată pentru credite – acestea rămân disponibile până la consum
Fluxul de facturare cu credite
Este util să cunoașteți ordinea de consum înainte de a configura orice, deoarece aceasta determină ce afișează fiecare dintre panourile dumneavoastră de control. Creditele sunt utilizate primele, iar facturarea lunară preia ștafeta ulterior: cu alte cuvinte, un sold preplătit care stagnează la zero în timp ce totul funcționează înseamnă că ați trecut deja la postplătit fără să vă dați seama.
- Credite preplătite disponibile: token-urile sunt deduse din soldul preplătit
- Credite epuizate: consumul trece la facturarea lunară (postplătit)
- Limita de cheltuieli atinsă: cererile sunt refuzate
Strategii de utilizare a creditelor
Buget lunar fix
Aceasta este strategia bugetară rigidă: fără activarea facturării lunare, epuizarea creditelor oprește apelurile în loc să genereze datorii. Asumați-vă compromisul – serviciul se întrerupe, iar este mai bine ca aceasta să fie o alegere explicită decât o descoperire făcută într-o vineri seara. Combinați-o cu alerta de sold scăzut descrisă mai jos.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Verificare sold
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)
# Reîncărcare dacă soldul este scăzut
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}")
Alocarea pentru proiecte
Alocarea pentru proiecte are un avantaj dincolo de contabilitate: soldul devine o măsură a progresului. Dacă jumătate din credite sunt consumate în timp ce un sfert din lucru este finalizat, primiți această informație înainte de final, când mai aveți timp să decideți dacă reduceți amploarea sau schimbați modelele.
# Buget proiect: 500 $ pe 3 luni
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}'
Apoi monitorizați utilizarea prin analitice (lecția următoare) pentru a vă asigura că bugetul este respectat.
Monitorizarea soldului
Alertă de sold scăzut
#!/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 $)"
# Trimiteți o notificare
fi
Panou de control al utilizării
Combinați soldul preplătit cu previzualizarea taxelor postplătite pentru o imagine completă a costurilor dumneavoastră:
# Sold preplătit
echo "=== Prepaid Credits ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Taxe postplătite curente
echo "=== Postpaid Charges ==="
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
Puncte cheie
GET /v1/billing/teams/{teamId}/prepaid/balancereturnează soldul și istoriculPOST /v1/billing/teams/{teamId}/prepaid/top-upachiziționează credite (debitare imediată)- Creditele preplătite nu sunt rambursabile
- Creditele sunt consumate înainte de facturarea lunară
- Automatizați reîncărcările cu un prag minim pentru a evita întreruperile
- Combinați creditele preplătite și limitele de cheltuieli pentru un control total al costurilor