Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Išankstiniai kreditai

Paskaita 8 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. xAI išankstinio apmokėjimo modelis
  2. Likučio tikrinimas
  3. Kreditų įsigijimas (papildymas)
  4. Kreditų naudojimo strategijos
  5. Likučio stebėjimas
  6. Svarbiausi punktai

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ę.

  1. Yra išankstinių kreditų: tokenai nurašomi iš išankstinio mokėjimo likučio
  2. Kreditai išseko: vartojimas perjungiamas į mėnesinį atsiskaitymą (po fakto)
  3. 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/balance grąž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