Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Ettemakstud krediit

Õppetund 8 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. xAI ettemakstud mudel
  2. Saldi kontrollimine
  3. Krediidi ostmine (saldo täiendamine)
  4. Krediidi kasutamise strateegiad
  5. Saldo jälgimine
  6. Peamised punktid

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.

  1. Ettemakstud krediit on saadaval: tokenid lahutatakse ettemakstud saldost
  2. Krediit on otsas: tarbimine lülitub igakuisele arveldusele (järelmaks)
  3. 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/balance tagastab saldo ja ajaloo
  • POST /v1/billing/teams/{teamId}/prepaid/top-up ostab 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