Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Krediti Mħallsa Minn Qabel

Lezzjoni 8 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Il-mudell prepaid ta’ xAI
  2. Iċċekkja l-bilanċ tiegħek
  3. Ixtri krediti (rikariga)
  4. Strateġiji ta’ użu tal-krediti
  5. Monitoraġġ tal-bilanċ
  6. Punti Ewlenin

Il-mudell prepaid ta’ xAI

Il-krediti mħallsa minn qabel (prepaid) jħalluk tixtri bilanċ bil-quddiem, li jiġi kkunsmat hekk kif tagħmel sejħiet tal-API. Dan il-mudell huwa ideali biex tikkontrolla n-nefqiet: tonfoq biss dak li xtrajt, mingħajr sorpriżi fi tmiem ix-xahar. Il-krediti jintużaw qabel il-fatturazzjoni ta’ kull xahar.

Iċċekkja l-bilanċ tiegħek

Il-prepaid ibiddel ir-relazzjoni tar-riskju meta mqabbla mal-fatturazzjoni ta’ kull xahar. Bil-postpaid, issib l-ammont fi tmiem il-perjodu; bil-prepaid, il-limitu huwa stabbilit minn qabel u l-agħar xenarju huwa interruzzjoni tas-servizz—spijaċevoli, iżda limitata. Għal tim li qed jesplora l-API jew għal proġett b’baġit fiss, dan huwa l-kompromess it-tajjeb.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Ir-risposta fiha:

  • Il-bilanċ kurrenti f’dollari
  • L-istorja ta’ rikariki bid-dati u l-ammonti
  • L-istorja tal-użu skont il-perjodu

Ixtri krediti (rikariga)

Biex terġa’ timla l-bilanċ tal-krediti tiegħek:

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
  }'

Punti importanti dwar il-krediti

L-erba’ punti hawn taħt għandhom konsegwenzi konkreti fuq kif tawtomatizza. It-tieni wieħed speċjalment: il-krediti ma jistgħux jiġu rrimborżati. Dan waħdu jeskludi l-istrateġija ta’ xirja waħda kbira “biex tkun sikur”—rikarigi żgħar u frekwenti huma aħjar, anke jekk tawtomatizzahom, milli kapital marbut f’proġett li jista’ jbiddel id-direzzjoni tiegħu.

  • Il-krediti jiġu addebitati immedjatament max-xiri fuq il-metodu ta’ ħlas predefinit tiegħek
  • Il-krediti prepaid huma mhux rimborżabbli (ħlief jekk meħtieġ legalment fil-ġuriżdizzjoni tiegħek)
  • Il-krediti jiġu kkunżmati b’prijorità qabel il-fatturazzjoni postpaid ta’ kull xahar
  • M’hemm l-ebda data ta’ skadenza elenkata għall-krediti—jibqgħu disponibbli sakemm jiġu kkunżmati

Fluss tal-fatturazzjoni bil-krediti

Jiswa li tkun taf l-ordni tal-konsum qabel ma tikkonfigura xejn, peress li dan jiddetermina x’juri kull wieħed mid-dashboards tiegħek. Il-krediti jiġu l-ewwel, il-fatturazzjoni ta’ kull xahar tieħu f’idejha wara: fi kliem ieħor, bilanċ prepaid li jibqa’ wieqaf fuq żero filwaqt li kollox jaħdem ifisser li diġà biddilt għall-postpaid mingħajr ma ndunajt.

  1. Krediti prepaid disponibbli: it-tokens jitnaqqsu mill-bilanċ prepaid
  2. Krediti eżawriti: il-konsum jibdel għall-fatturazzjoni ta’ kull xahar (postpaid)
  3. Limitu ta’ nfiq milħuq: it-talbiet jiġu miċħuda

Strateġiji ta’ użu tal-krediti

Baġit fiss ta’ kull xahar

Din hija l-istrateġija tal-baġit iebsa: mingħajr fatturazzjoni ta’ kull xahar attivata, li jispiċċaw il-krediti iwaqqaf is-sejħiet minflok ma jiġġenera dejn. Aċċetta l-kompromess—is-servizz jinterrampi, u huwa aħjar li din tkun għażla espliċita milli skoperta ta’ nhar ta’ Ġimgħa filgħaxija. Għaqqadha mal-allerta ta’ bilanċ baxx deskritta aktar tard.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Iċċekkja l-bilanċ
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)

# Erġa' ċċarġja jekk il-bilanċ ikun baxx
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}")

Provvista tal-proġett

Il-provvista tal-proġett għandha vantaġġ lil hinn mill-kontabbiltà: il-bilanċ isir kejl tal-progress. Jekk nofs il-krediti jiġu kkunżmati filwaqt li kwart tax-xogħol ikun sar, tikseb l-informazzjoni qabel tmiem il-proġett, meta jkun hemm ħin biex tiddeċiedi jekk tridx tonqos l-ambitu jew tibdel il-mudelli.

# Baġit tal-proġett: $500 fuq 3 xhur
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}'

Imbagħad immonitorja l-użu permezz tal-analitika (lezzjoni li jmiss) biex tiżgura li l-baġit jiġi rrispettat.

Monitoraġġ tal-bilanċ

Allerta ta’ bilanċ baxx

#!/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 $)"
    # Ibgħat notifika
fi

Dashboard tal-użu

Għaqqad il-bilanċ prepaid mal-previżjoni tal-ħlasijiet postpaid għal veduta sħiħa tal-ispejjeż tiegħek:

# Bilanċ Prepaid
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

# Ħlasijiet Postpaid kurrenti
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

Punti Ewlenin

  • GET /v1/billing/teams/{teamId}/prepaid/balance jirritorna l-bilanċ u l-istorja
  • POST /v1/billing/teams/{teamId}/prepaid/top-up jixtri krediti (addebitati immedjatament)
  • Il-krediti prepaid huma mhux rimborżabbli
  • Il-krediti jiġu kkunżmati qabel il-fatturazzjoni ta’ kull xahar
  • Awtomatizza r-rikariki b’limitu minimu biex tevita interruzzjonijiet
  • Għaqqad krediti prepaid u limiti ta’ nfiq għal kontroll totali tal-ispejjeż