Ettemakstud krediit
Sellel lehel
xAI ettemakstud mudel
Ettemakstud krediit võimaldab sul soetada saldot ette, mida tarbid API päringute tegemisel. See mudel on ideaalne kulude kontrollimiseks: kulutad ainult seda, mida oled ostnud, ilma kuu lõpu üllatusteta. Krediiti kasutatakse enne igakuist arveldust.
Saldi kontrollimine
Ettemakse pöörab riskisuhte võrreldes igakuise järelmaksuga vastupidiseks. Järelmaksu korral saad summa teada kuu lõpus; ettemaksu puhul on limiit ette määratud ja halvim stsenaarium on teenuse katkemine – ebameeldiv, kuid piiratud. Meeskonnale, kes uurib API-d, või projektile fikseeritud eelarvega on see õige kompromiss.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastus sisaldab:
- Praegust saldot dollarites
- Saldo täiendamise ajalugu kuupäevade ja summadega
- Kasutusajalugu periooditi
Krediidi ostmine (saldo täiendamine)
Krediidi saldo täiendamiseks:
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
}'
Olulised punktid krediidi kohta
Allpool toodud neljal punktil on konkreetsed tagajärjed automatiseerimisele. Eriti teine: krediiti ei tagastata. See üksi välistab strateegia osta üks suur summa „igaks juhuks“ – tagasihoidlikud ja sagedased täiendused on paremad, isegi kui need automatiseerid, kui projekti, mis võib suunda muuta, seotud kapital.
- Krediit kantakse maha koheselt ostu hetkel sinu vaikimisi makseviisilt
- Ettemakstud krediiti ei tagastata (välja arvatud juhul, kui see on sinu jurisdiktsioonis seadusega nõutud)
- Krediiti tarbitakse esmajärjekorras enne igakuist järelmaksuarveldust
- Krediidile pole märgitud aegumiskuupäeva – need jäävad kättesaadavaks kuni tarbimiseni
Arveldusvoog krediidi kasutamisel
Enne seadistamist tasub teada tarbimise järjekorda, sest see määrab, mida sinu armatuurlauad näitavad. Krediit läheb esimesena, igakuine arveldus võtab ohjad pärast üle: teisisõnu, kui ettemakstud saldo seisab nullis ja kõik toimib, oled juba märkamatult üle läinud järelmaksule.
- Ettemakstud krediit on saadaval: tokenid lahutatakse ettemakstud saldost
- Krediit on otsas: tarbimine lülitub igakuisele arveldusele (järelmaks)
- Kululimiit on saavutatud: päringud lükatakse tagasi
Krediidi kasutamise strateegiad
Fikseeritud igakuine eelarve
See on range eelarve strateegia: kui igakuist arveldust pole lubatud, peatab krediidi lõppemine päringud instead võla tekitamise. Nõustu kompromissiga – teenus katkeb, ja parem on, kui see on selge valik, mitte reede õhtune avastus. Kombineeri seda hiljem kirjeldatud väikse saldo hoiatusega.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Kontrolli saldot
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)
# Täienda, kui saldo on madal
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}")
Projekti varustamine
Projekti varustamisel on lisaks raamatupidamisele veel üks eelis: saldost saab edenemise mõõt. Kui pool krediiti on tarbitud, kui veerand tööst on tehtud, saad info enne lõppu, kui on veel aega otsustada, kas vähendada mahtu või vahetada mudeleid.
# Projekti eelarve: 500 $ 3 kuu jooksul
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}'
Seejärel jälgi kasutust analüütika kaudu (järgmine tund), et tagada eelarve järgimine.
Saldo jälgimine
Madala saldo hoiatus
#!/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 $)"
# Saada teavitus
fi
Kasutuse armatuurlaud
Kombineeri ettemakstud saldo järelmaksu arve eelvaatega, et saada täielik ülevaade oma kuludest:
# Ettemakstud saldo
echo "=== Ettemakstud krediit ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Praegused järelmaksu tasud
echo "=== Järelmaksu tasud ==="
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
Peamised punktid
GET /v1/billing/teams/{teamId}/prepaid/balancetagastab saldo ja ajalooPOST /v1/billing/teams/{teamId}/prepaid/top-upostab krediiti (kannetakse maha koheselt)- Ettemakstud krediiti ei tagastata
- Krediiti tarbitakse enne igakuist arveldust
- Automatiseeri saldo täiendamist miinimumlävendiga, et vältida katkestusi
- Kombineeri ettemakstud krediit ja kululimiidid kulude täielikuks kontrollimiseks