Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Kredīti ar priekšapmaksu

Nodarbība 8 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. xAI priekšapmaksas modelis
  2. Pārbaudi savu atlikumu
  3. Kredītu iegāde (papildināšana)
  4. Kredītu lietošanas stratēģijas
  5. Atlikuma uzraudzība
  6. Galvenās atziņas

xAI priekšapmaksas modelis

Kredīti ar priekšapmaksu ļauj tev iepriekš iegādāties naudas atlikumu, kas tiek izlietots, veicot API izsaukumus. Šis modelis ir ideāls izdevumu kontrolei: tu tērē tikai tik daudz, cik esi iegādājies, bez nepatīkamiem pārsteigumiem mēneša beigās. Kredīti tiek izmantoti pirms ikmēneša rēķinu sagatavošanas.

Pārbaudi savu atlikumu

Priekšapmaksa maina riska attiecības salīdzinājumā ar ikmēneša rēķinu sagatavošanu. Pie pēcapmaksas tu uzzini summu tikai mēneša beigās; pie priekšapmaksas limits ir noteikts iepriekš, un sliktākais scenārijs ir pakalpojuma pārtraukšana — nepatīkami, bet ierobežoti. Komandai, kas pēta API, vai projektam ar fiksētu budžetu šis ir pareizais kompromiss.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Atbilde satur:

  • Pašreizējo atlikumu dolāros
  • Papildināšanas vēsturi ar datumiem un summām
  • Lietošanas vēsturi pa periodiem

Kredītu iegāde (papildināšana)

Lai papildinātu savu kredītu atlikumu:

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
  }'

Svarīgi punkti par kredītiem

Četriem turpmāk minētajiem punktiem ir konkrētas sekas tam, kā tu automatizēsi procesus. Īpaši otrais: kredītus neatmaksā. Tas vien jau izslēdz stratēģiju veikt vienu lielu pirkumu „drošības pēc”. Mazāki, biežāki papildinājumi ir labāki, pat ja tos automatizē, nekā kapitāls, kas iesaldēts projektā, kurš var mainīt virzienu.

  • Par kredītiem tiek veikta maksājuma operācija nekavējoties pirkuma brīdī, izmantojot tavu noklusējuma maksājuma metodi
  • Priekšapmaksas kredīti ir neatmaksājami (izņemot gadījumus, kad to pieprasa likumdošana tavā jurisdikcijā)
  • Kredīti tiek izlietoti prioritārā kārtā pirms ikmēneša pēcapmaksas rēķinu sagatavošanas
  • Kredītiem nav norādīts derīguma termiņš — tie paliek pieejami, līdz tiek izlietoti

Rēķinu plūsma, izmantojot kredītus

Ir vērts zināt patēriņa secību pirms jebkādas konfigurēšanas, jo tas nosaka, ko rādīs tavi informācijas paneļi. Vispirms tiek izmantoti kredīti, pēc tam pārņem ikmēneša rēķinu sagatavošana: citiem vārdiem sakot, ja priekšapmaksas atlikums stagnē pie nulles, kamēr viss strādā, tas nozīmē, ka jau esi pārgājis uz pēcapmaksu, to nemanot.

  1. Pieejami priekšapmaksas kredīti: tokeni tiek atskaitīti no priekšapmaksas atlikuma
  2. Kredīti izsmelti: patēriņš pāriet uz ikmēneša rēķinu sagatavošanu (pēcapmaksa)
  3. Sasniegts izdevumu limits: pieprasījumi tiek noraidīti

Kredītu lietošanas stratēģijas

Fiksēts ikmēneša budžets

Šī ir stingra budžeta stratēģija: ja ikmēneša rēķinu sagatavošana nav aktivizēta, kredītu izsmelšana aptur izsaukumus, nevis ģenerē parādu. Pieņem šo kompromisu — pakalpojums tiek pārtraukts, un labāk, ja tas ir apzināta izvēle, nevis atklājums piektdienas vakarā. Apvieno to ar vēlāk aprakstīto brīdinājumu par zemu atlikumu.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Pārbaudi atlikumu
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)

# Papildini, ja atlikums ir zems
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}")

Projekta nodrošināšana

Projekta nodrošināšanai ir priekšrocība papildus grāmatvedībai: atlikums kļūst par progresa mēru. Ja puse kredītu ir izlietota, kamēr paveikts tikai ceturtdaļa darba, tu saņem šo informāciju laicīgi, kad vēl ir iespējams izlemt, vai samazināt apjomu vai mainīt modeļus.

# Projekta budžets: 500 USD 3 mēnešiem
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}'

Pēc tam uzraugi lietojumu, izmantojot analītiku (nākamajā nodarbībā), lai nodrošinātu budžeta ievērošanu.

Atlikuma uzraudzība

Brīdinājums par zemu atlikumu

#!/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 $)"
    # Sūti paziņojumu
fi

Lietošanas informācijas panelis

Apvieno priekšapmaksas atlikumu ar pēcapmaksas maksājumu priekšskatījumu, lai iegūtu pilnīgu priekšstatu par savām izmaksām:

# Priekšapmaksas atlikums
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

# Pašreizējie pēcapmaksas maksājumi
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

Galvenās atziņas

  • GET /v1/billing/teams/{teamId}/prepaid/balance atgriež atlikumu un vēsturi
  • POST /v1/billing/teams/{teamId}/prepaid/top-up iegādājas kredītus (maksājums tiek veikts nekavējoties)
  • Priekšapmaksas kredīti ir neatmaksājami
  • Kredīti tiek izlietoti pirms ikmēneša rēķinu sagatavošanas
  • Automatizē papildināšanu ar minimālo slieksni, lai izvairītos no pārtraukumiem
  • Apvieno priekšapmaksas kredītus un izdevumu limitus, lai nodrošinātu pilnīgu izmaksu kontroli