Salt la conținutul principal
Română— Alege o limbă
Meniu

Credite preplătite

Lecția 8 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Modelul preplătit xAI
  2. Verificarea soldului
  3. Achiziționarea de credite (reîncărcare)
  4. Strategii de utilizare a creditelor
  5. Monitorizarea soldului
  6. Puncte cheie

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.

  1. Credite preplătite disponibile: token-urile sunt deduse din soldul preplătit
  2. Credite epuizate: consumul trece la facturarea lunară (postplătit)
  3. 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/balance returnează soldul și istoricul
  • POST /v1/billing/teams/{teamId}/prepaid/top-up achiziț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