Ennakkomaksuhyvitykset
Tällä sivulla
xAI:n ennakkomaksumalli
Ennakkomaksuhyvitysten avulla ostat saldoa etukäteen, ja sitä kulutetaan API-kutsujen myötä. Tämä malli sopii erinomaisesti kulujen hallintaan: käytät vain sen, mitä olet ostanut, ilman yllätyksiä kuukauden lopussa. Hyvityksiä käytetään ennen kuukausilaskutusta.
Saldon tarkistaminen
Ennakkomaksu kääntää riskisuhteen päinvastaiseksi verrattuna kuukausilaskutukseen. Jälkikäteen laskettaessa summa selviää vasta kuukauden päätteeksi; ennakkomaksussa katto asetetaan etukäteen, ja pahin mahdollinen skenaario on palvelun keskeytyminen – ikävää, mutta rajattua. Tiimille, joka tutkii API:a, tai hankkeelle, jolla on kiinteä budjetti, tämä on oikea kompromissi.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastaus sisältää:
- Nykyisen saldon dollareina
- Lataushistorian päivämäärineen ja summilleen
- Käyttöhistorian jaksoittain
Hyvitysten ostaminen (lataus)
Ladataksesi hyvityssaldoasi:
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
}'
Tärkeää hyvityksistä
Alla olevilla neljällä kohdalla on konkreettisia seurauksia automaatiollesi. Toinen kohta on erityisen tärkeä: hyvityksiä ei hyvitetä. Tämä yksinään sulkee pois strategian, jossa ostettaisiin yksi suuri erä “varmuuden vuoksi”. Pienet ja usein toistuvat lataukset ovat parempi ratkaisu – vaikka automatisoisit ne – kuin pääoman sitominen projektiin, jonka suunta voi muuttua.
- Hyvitykset veloitetaan välittömästi ostohetkellä oletusmaksutavaltasi
- Ennakkomaksuhyvityksiä ei hyvitetä (ellei lain vaatima paikallisella lainkäyttöalueellasi)
- Hyvityksiä kulutetaan ensisijaisesti ennen kuukausittaista jälkikäteen tapahtuvaa laskutusta
- Hyvityksille ei ole määritelty vanhenemispäivää – ne pysyvät käytettävissä, kunnes ne on kulutettu
Laskutusvirta hyvitysten kanssa
On hyvä tuntea kulutusjärjestys ennen kuin määrittelet mitään, sillä se määrää, mitä dashboardisi näyttävät. Hyvitykset käytetään ensin, ja kuukausilaskutus astuu voimaan niiden jälkeen: toisin sanoen, jos ennakkomaksusaldo on jumissa nollassa ja kaikki toimii, olet siirtynyt jälkikäteen laskutettavaksi huomaamattasi.
- Ennakkomaksuhyvityksiä saatavilla: tokenit vähennetään ennakkomaksusaldosta
- Hyvitykset loppuneet: kulutus siirtyy kuukausilaskutukseen (jälkikäteen laskutettava)
- Kuluraja saavutettu: pyynnöt evätään
Hyvitysten käyttöstrategiat
Kiinteä kuukausibudjetti
Tämä on tiukan budjetin strategia: ilman käytössä olevaa kuukausilaskutusta hyvitysten loppuminen pysäyttää kutsut velan muodostumisen sijaan. Hyväksy kompromissi – palvelu keskeytyy, ja on parempi, että tämä on tietoinen valinta kuin perjantai-iltana tehtävä havainto. Yhdistä tämä myöhemmin kuvattuun matalan saldon hälytykseen.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Tarkista saldo
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)
# Lataa, jos saldo on matala
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"Ladattu ${top_up_amount:.2f}")
Projektin resursointi
Projektin resursoinnilla on etunsa kirjanpidon lisäksi: saldosta tulee edistymisen mittari. Jos puolet hyvityksistä on kulutettu, kun neljäsosa työstä on tehty, saat tiedon ajoissa ennen loppua, jolloin sinulla on vielä aikaa päättää, vähennetäänkö laajuutta vai vaihdetaanko malleja.
# Projektibudjetti: 500 $ kolmelle kuukaudelle
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}'
Seuraa tämän jälkeen käyttöä analytiikan avulla (seuraava oppitunti) varmistaaksesi, että budjettia noudatetaan.
Saldon seuranta
Matalan saldon hälytys
#!/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 "HÄLYTYS: matala ennakkomaksusaldo ($BALANCE $)"
# Lähetä ilmoitus
fi
Käyttödashboard
Yhdistä ennakkomaksusaldo jälkikäteen laskutettavien maksujen esikatseluun saadaksesi kokonaiskuvan kuluistasi:
# Ennakkomaksusaldo
echo "=== Ennakkomaksuhyvitykset ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
# Nykyiset jälkikäteen laskutettavat maksut
echo "=== Jälkikäteen laskutettavat maksut ==="
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
Keskeiset asiat
GET /v1/billing/teams/{teamId}/prepaid/balancepalauttaa saldon ja historianPOST /v1/billing/teams/{teamId}/prepaid/top-upostaa hyvityksiä (veloitetaan välittömästi)- Ennakkomaksuhyvityksiä ei hyvitetä
- Hyvitykset kulutetaan ennen kuukausilaskutusta
- Automatisoi lataukset asettamalla minimikynnys keskeytysten välttämiseksi
- Yhdistä ennakkomaksuhyvitykset ja kulurajat kustannusten täydelliseen hallintaan