Kredīti ar priekšapmaksu
Šajā lapā
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.
- Pieejami priekšapmaksas kredīti: tokeni tiek atskaitīti no priekšapmaksas atlikuma
- Kredīti izsmelti: patēriņš pāriet uz ikmēneša rēķinu sagatavošanu (pēcapmaksa)
- 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/balanceatgriež atlikumu un vēsturiPOST /v1/billing/teams/{teamId}/prepaid/top-upiegā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