Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Ennakkomaksuhyvitykset

Oppitunti 8 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. xAI:n ennakkomaksumalli
  2. Saldon tarkistaminen
  3. Hyvitysten ostaminen (lataus)
  4. Hyvitysten käyttöstrategiat
  5. Saldon seuranta
  6. Keskeiset asiat

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.

  1. Ennakkomaksuhyvityksiä saatavilla: tokenit vähennetään ennakkomaksusaldosta
  2. Hyvitykset loppuneet: kulutus siirtyy kuukausilaskutukseen (jälkikäteen laskutettava)
  3. 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/balance palauttaa saldon ja historian
  • POST /v1/billing/teams/{teamId}/prepaid/top-up ostaa 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