Krediti Mħallsa Minn Qabel
F'din il-paġna
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.
- Krediti prepaid disponibbli: it-tokens jitnaqqsu mill-bilanċ prepaid
- Krediti eżawriti: il-konsum jibdel għall-fatturazzjoni ta’ kull xahar (postpaid)
- 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/balancejirritorna l-bilanċ u l-istorjaPOST /v1/billing/teams/{teamId}/prepaid/top-upjixtri 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ż