Išankstiniai kreditai
Šiame puslapyje
xAI išankstinio apmokėjimo modelis
Išankstiniai kreditai leidžia iš anksto įsigyti likutį, kuris sunaudojamas atliekant API užklausas. Šis modelis idealiai tinka išlaidoms kontroliuoti: išleidžiama tik tiek, kiek įsigyta, jokių netikėtumų mėnesio pabaigoje. Kreditai naudojami prieš mėnesinį atsiskaitymą.
Likučio tikrinimas
Išankstinis apmokėjimas keičia rizikos santykį, palyginti su mėnesiniu atsiskaitymu. Apmokant po fakto, sumą sužinai mėnesio pabaigoje; išankstinio apmokėjimo atveju limitas nustatomas iš anksto, o blogiausiu atveju paslauga tiesiog sustabdoma – nemalonu, bet situacija yra valdoma. Komandai, tyrinėjančiai API, arba projektui su fiksuotu biudžetu tai yra tinkamas kompromisas.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Atsakyme rasite:
- Dabartinį likutį doleriais
- Papildymo istoriją su datomis ir sumomis
- Naudojimo istoriją pagal laikotarpius
Kreditų įsigijimas (papildymas)
Norėdami papildyti kreditų likutį:
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
}'
Svarbūs dalykai apie kreditus
Šie keturi punktai turi konkrečių pasekmių automatizavimui. Ypač antrasis: kreditai negrąžinami. Vien tai paneigia strategiją pirkti vieną didelę sumą „saugumo sumetimais“ – geriau dažniau papildyti mažesnėmis sumomis, net jei tai automatizuota, nei laikyti lėšas projekte, kuris gali pakeisti kryptį.
- Už kreditus nuskaitoma iš karto pirkimo metu iš jūsų numatytojo mokėjimo būdo
- Išankstiniai kreditai yra negrąžinami (nebent tai numatyta jūsų jurisdikcijos įstatymuose)
- Kreditai sunaudojami pirmiausia, prieš mėnesinį atsiskaitymą po fakto
- Kreditams netaikomas galiojimo terminas – jie lieka prieinami, kol yra sunaudojami
Atsiskaitymo eiga naudojant kreditus
Verta žinoti vartojimo eiliškumą prieš ką nors konfigūruojant, nes tai lemia, ką rodys jūsų skydeliai. Pirmiausia naudojami kreditai, vėliau perimamas mėnesinis atsiskaitymas: kitaip tariant, jei išankstinio mokėjimo likutis sustingsta ties nuliu, o viskas veikia, vadinasi, jau perėjote prie atsiskaitymo po fakto to nesupratę.
- Yra išankstinių kreditų: tokenai nurašomi iš išankstinio mokėjimo likučio
- Kreditai išseko: vartojimas perjungiamas į mėnesinį atsiskaitymą (po fakto)
- Pasiektas išlaidų limitas: užklausos atmetamos
Kreditų naudojimo strategijos
Fiksuotas mėnesinis biudžetas
Tai griežto biudžeto strategija: neįjungus mėnesinio atsiskaitymo, kreditams išsekus užklausos sustabdomos vietoj to, kad būtų generuojama skola. Priimkite šį kompromisą – paslauga nutrūksta, ir geriau, kad tai būtų sąmoningas pasirinkimas, o ne atradimas penktadienio vakarą. Derinkite tai su vėliau aprašytu įspėjimu apie mažą likutį.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Tikrinti likutį
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)
# Papildyti, jei likutis mažas
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}")
Projekto aprūpinimas
Projekto aprūpinimas turi pranašumą ne tik apskaitos požiūriu: likutis tampa progreso matu. Jei sunaudota pusė kreditų, o atlikta tik ketvirtadalio darbų, tai sužinote dar prieš pabaigą, kai dar turite laiko nuspręsti, ar mažinti apimtį, ar keisti modelius.
# Projekto biudžetas: 500 $ per 3 mėnesius
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}'
Tada stebėkite naudojimą per analitiką (kitoje pamokoje), kad būtų laikomasi biudžeto.
Likučio stebėjimas
Įspėjimas apie mažą likutį
#!/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 $)"
# Siųsti pranešimą
fi
Naudojimo skydelis
Sujunkite išankstinio mokėjimo likutį su mėnesinio atsiskaitymo sąskaitos peržiūra, kad gautumėte išsamų išlaidų vaizdą:
# Išankstinio mokėjimo likutis
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
# Dabartiniai mėnesiniai mokesčiai
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
Svarbiausi punktai
GET /v1/billing/teams/{teamId}/prepaid/balancegrąžina likutį ir istorijąPOST /v1/billing/teams/{teamId}/prepaid/top-upįsigyja kreditus (nuskaitoma iš karto)- Išankstiniai kreditai yra negrąžinami
- Kreditai sunaudojami prieš mėnesinį atsiskaitymą
- Automatizuokite papildymą nustatydami minimalų slenkstį, kad išvengtumėte sutrikimų
- Derinkite išankstinius kreditus ir išlaidų limitus visapusiškai išlaidų kontrolei