Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Πιστωτικά Υπόλοιπα Προπληρωμής

Μάθημα 8 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Μοντέλο προπληρωμής της xAI
  2. Έλεγχος του υπολοίπου σας
  3. Αγορά πιστώσεων (επαναφόρτιση)
  4. Στρατηγικές χρήσης πιστώσεων
  5. Παρακολούθηση υπολοίπου
  6. Βασικά σημεία

Μοντέλο προπληρωμής της xAI

Τα πιστωτικά υπόλοιπα προπληρωμής σάς επιτρέπουν να αγοράζετε ένα υπόλοιπο εκ των προτέρων, το οποίο καταναλώνεται καθώς πραγματοποιείτε κλήσεις API. Αυτό το μοντέλο είναι ιδανικό για τον έλεγχο των δαπανών: ξοδεύετε μόνο όσα αγοράσατε, χωρίς δυσάρεστες εκπλήξεις στο τέλος του μήνα. Οι πιστώσεις χρησιμοποιούνται πριν από την μηνιαία χρέωση.

Έλεγχος του υπολοίπου σας

Η προπληρωμή αντιστρέφει τη σχέση ρίσκου σε σύγκριση με την μηνιαία χρέωση. Με την μεταχρέωση (postpaid), ανακαλύπτετε το ποσό στο τέλος· με την προπληρωμή, το ανώτατο όριο καθορίζεται εκ των προτέρων και το χειρότερο σενάριο είναι η διακοπή της υπηρεσίας—δυσάρεστο, αλλά οριοθετημένο. Για μια ομάδα που εξερευνά το API ή για ένα έργο με σταθερό προϋπολογισμό, αυτή είναι η σωστή ανταλλαγή.

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

Η απάντηση περιέχει:

  • Το τρέχον υπόλοιπο σε δολάρια
  • Το ιστορικό επαναφόρτισης με ημερομηνίες και ποσά
  • Το ιστορικό χρήσης ανά περίοδο

Αγορά πιστώσεων (επαναφόρτιση)

Για να επαναφορτίσετε το υπόλοιπο των πιστώσεών σας:

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

Σημαντικά σημεία σχετικά με τις πιστώσεις

Τα τέσσερα σημεία παρακάτω έχουν συγκεκριμένες συνέπειες στον τρόπο που αυτοματοποιείτε τις διαδικασίες. Το δεύτερο ειδικότερα: οι πιστώσεις δεν επιστρέφονται. Αυτό από μόνο του αποκλείει τη στρατηγική μίας μεγάλης αγοράς «για κάθε ενδεχόμενο»· οι μέτριες και συχνές επαναφορτίσεις είναι προτιμότερες, ακόμα και αν τις αυτοματοποιείτε, από κεφάλαια δεσμευμένα σε ένα έργο που μπορεί να αλλάξει κατεύθυνση.

  • Οι πιστώσεις χρεώνονται άμεσα κατά την αγορά στον προεπιλεγμένο τρόπο πληρωμής σας
  • Οι πιστώσεις προπληρωμής δεν επιστρέφονται (εκτός εάν απαιτείται νομικά στη δικαιοδοσία σας)
  • Οι πιστώσεις καταναλώνονται κατά προτεραιότητα πριν από την μηνιαία χρέωση μεταχρέωσης (postpaid)
  • Δεν αναφέρεται ημερομηνία λήξης για τις πιστώσεις—παραμένουν διαθέσιμες μέχρι να καταναλωθούν

Ροή χρέωσης με πιστώσεις

Αξίζει να γνωρίζετε τη σειρά κατανάλωσης πριν διαμορφώσετε οτιδήποτε, καθώς αυτό καθορίζει τι εμφανίζεται σε κάθε έναν από τους πίνακες ελέγχου σας. Οι πιστώσεις χρησιμοποιούνται πρώτες, η μηνιαία χρέωση αναλαμβάνει στη συνέχεια: με άλλα λόγια, ένα υπόλοιπο προπληρωμής που λιμνάζει στο μηδέν ενώ όλα λειτουργούν, σημαίνει ότι έχετε ήδη μεταβεί στη μεταχρέωση χωρίς να το αντιληφθείτε.

  1. Διαθέσιμες πιστώσεις προπληρωμής: τα tokens αφαιρούνται από το υπόλοιπο προπληρωμής
  2. Εξάντληση πιστώσεων: η κατανάλωση μεταβαίνει στην μηνιαία χρέωση (μεταχρέωση)
  3. Επίτευξη ορίου δαπανών: τα αιτήματα απορρίπτονται

Στρατηγικές χρήσης πιστώσεων

Σταθερός μηνιαίος προϋπολογισμός

Αυτή είναι η στρατηγική αυστηρού προϋπολογισμού: χωρίς ενεργοποιημένη την μηνιαία χρέωση, η εξάντληση των πιστώσεων σταματά τις κλήσεις αντί να δημιουργεί χρέος. Αποδεχτείτε την ανταλλαγή—η υπηρεσία διακόπτεται, και είναι προτιμότερο αυτό να είναι μια ρητή επιλογή παρά μια ανακάλυψη το βράδυ της Παρασκευής. Συνδυάστε το με την ειδοποίηση χαμηλού υπολοίπου που περιγράφεται παρακάτω.

import requests
from datetime import datetime

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

# Έλεγχος υπολοίπου
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)

# Επαναφόρτιση αν το υπόλοιπο είναι χαμηλό
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"Επαναφόρτιση ${top_up_amount:.2f}")

Προμήθεια έργου

Η προμήθεια έργου έχει ένα πλεονέκτημα πέρα από τη λογιστική: το υπόλοιπο γίνεται μέτρο προόδου. Εάν οι μισές πιστώσεις έχουν καταναλωθεί ενώ έχει ολοκληρωθεί μόνο το ένα τέταρτο της εργασίας, λαμβάνετε την πληροφορία πριν από το τέλος, όταν υπάρχει ακόμα χρόνος να αποφασίσετε εάν θα μειώσετε το εύρος ή θα αλλάξετε μοντέλα.

# Προϋπολογισμός έργου: 500$ over 3 months
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}'

Στη συνέχεια, παρακολουθήστε τη χρήση μέσω αναλυτικών στοιχείων (επόμενο μάθημα) για να διασφαλίσετε ότι ο προϋπολογισμός τηρείται.

Παρακολούθηση υπολοίπου

Ειδοποίηση χαμηλού υπολοίπου

#!/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 "ΕΙΔΟΠΟΙΗΣΗ: χαμηλό υπόλοιπο προπληρωμής ($BALANCE $)"
    # Αποστολή ειδοποίησης
fi

Πίνακας ελέγχου χρήσης

Συνδυάστε το υπόλοιπο προπληρωμής με την προεπισκόπηση χρέωσης μεταχρέωσης για μια πλήρη εικόνα του κόστους σας:

# Υπόλοιπο προπληρωμής
echo "=== Πιστώσεις Προπληρωμής ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Τρέχουσες χρεώσεις μεταχρέωσης
echo "=== Χρεώσεις Μεταχρέωσης ==="
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

Βασικά σημεία

  • Το GET /v1/billing/teams/{teamId}/prepaid/balance επιστρέφει το υπόλοιπο και το ιστορικό
  • Το POST /v1/billing/teams/{teamId}/prepaid/top-up αγοράζει πιστώσεις (χρεώνονται άμεσα)
  • Οι πιστώσεις προπληρωμής δεν επιστρέφονται
  • Οι πιστώσεις καταναλώνονται πριν από την μηνιαία χρέωση
  • Αυτοματοποιήστε τις επαναφορτίσεις με ένα ελάχιστο όριο για να αποφύγετε διακοπές
  • Συνδυάστε τις πιστώσεις προπληρωμής και τα όρια δαπανών για συνολικό έλεγχο κόστους