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

Πληροφορίες Χρέωσης

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

Διαχείριση χρέωσης μέσω του API

Η ενότητα Χρέωσης του Management API σας επιτρέπει να ανακτάτε και να ενημερώνετε τα στοιχεία χρέωσής σας, να λαμβάνετε τιμολόγια και να παρακολουθείτε τις δαπάνες—όλα προγραμματιστικά. Δεν χρειάζεται πλέον να μεταβαίνετε συνεχώς στην κονσόλα για να ελέγξετε την κατάσταση των πληρωμών.

GET
Ανάκτηση
POST
Ενημέρωση
4
Καταστάσεις τιμολογίων
Μηνιαίος
Κύκλος χρέωσης

Ανάκτηση πληροφοριών χρέωσης

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

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

Η απόκριση περιέχει τα καταχωρημένα στοιχεία χρέωσης: επωνυμία εταιρείας, διεύθυνση, χώρα και αριθμό ΦΠΑ, εάν ισχύει.

Ενημέρωση πληροφοριών

Για να τροποποιήσετε τα στοιχεία χρέωσής σας:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "My Company SAS",
    "address": "15 Peace Street",
    "city": "Paris",
    "country": "FR",
    "vatNumber": "FR12345678901"
  }'

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

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

Ανάκτηση τιμολογίων

Το endpoint GET /v1/billing/teams/{teamId}/invoices επιστρέφει το ιστορικό των τιμολογίων σας:

# Τιμολόγια για έναν συγκεκριμένο μήνα
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Τιμολόγια από έναν δεδομένο μήνα και μετά
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Παράμετροι φιλτραρίσματος

  • billingCycle.year και billingCycle.month: ανάκτηση τιμολογίων για έναν συγκεκριμένο κύκλο
  • since.year και since.month: ανάκτηση όλων των τιμολογίων από έναν δεδομένο μήνα και μετά

Καταστάσεις τιμολογίων

Από αυτές τις τέσσερις καταστάσεις, μόνο μία απαιτεί άμεση ενέργεια. Η κατάσταση FAILED σημαίνει ότι η χρέωση δεν πραγματοποιήθηκε—ληγμένη κάρτα, επίτευξη ορίου, αμφισβήτηση—και ένα απλήρωτο τιμολόγιο οδηγεί τελικά σε αναστολή της υπηρεσίας. Αυτή είναι η κατάσταση που πρέπει να παρακολουθείτε αυτόματα, όπως φαίνεται στο μάθημα για τις μεθόδους πληρωμής· ελέγχετε τις άλλες τρεις, αλλά στέλνετε ειδοποίηση μόνο για αυτήν.

  • PENDING: το τιμολόγιο υποβάλλεται σε επεξεργασία· η πληρωμή δεν έχει χρεωθεί ακόμη
  • PAID: η πληρωμή ήταν επιτυχής
  • FAILED: η χρέωση απέτυχε (ληγμένη κάρτα, ανεπαρκή κεφάλαια κ.λπ.)
  • WILL_NEVER_BE_CHARGED: το τιμολόγιο δεν θα χρεωθεί ποτέ (πίστωση, προσαρμογή)

Λογική χρέωσης της xAI

Η κατανόηση του τρόπου αλληλεπίδρασης των δύο λειτουργιών αποτρέπει παρερμηνείες στον πίνακα ελέγχου σας. Οι προπληρωμένες πιστώσεις χρησιμοποιούνται πρώτες· η μηνιαία χρέωση ενεργοποιείται μόνο μόλις εξαντληθεί το υπόλοιπο. Ένα μηδενικό υπόλοιπο με ενεργή υπηρεσία δεν αποτελεί ανωμαλία: σημαίνει ότι πλέον καταναλώνετε με μεταχρονολογημένη χρέωση (postpaid) και το τιμολόγιο τέλους του μήνα συσσωρεύεται.

Προπληρωμένες πιστώσεις

Οι αγορασμένες πιστώσεις χρεώνονται αμέσως κατά τη στιγμή της αγοράς. Κάθε κλήση API καταναλώνει πιστώσεις με βάση τον αριθμό των tokens που υποβλήθηκαν σε επεξεργασία. Οι πιστώσεις χρησιμοποιούνται κατά προτεραιότητα.

Μηνιαία χρέωση (μεταχρονολογημένη)

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

Διαφορές στην καταμέτρηση tokens

Να αναμένετε απόκλιση μεταξύ της τοπικής σας καταμέτρησης και της καταμέτρησης χρέωσης· είναι προτιμότερο να το γνωρίζετε αυτό πριν χάσετε μισή μέρα προσπαθώντας να εντοπίσετε την αιτία. Η χρέωση είναι η αυθεντική πηγή: βασίστε τις εκτιμήσεις κόστους σας στα δεδομένα του Analytics API, ποτέ σε καταμέτρηση που πραγματοποιείται με έναν tokenizer στην πλευρά του πελάτη. Αυτό είναι φυσιολογικό: τα endpoints συμπερασμού προσθέτουν εσωτερικά tokens για επεξεργασία (οδηγίες συστήματος, μορφοποίηση), γεγονός που αυξάνει ελαφρώς τον χρεούμενο αριθμό σε σύγκριση με το ακατέργαστο κείμενο.

Προβολή τρεχουσών χρεώσεων

Για να δείτε τις συσσωρευμένες χρεώσεις πριν λήξει ο κύκλος:

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

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

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

  • Χρησιμοποιήστε GET και POST στο /v1/billing/teams/{teamId}/billing-info για να ανακτήσετε και να τροποποιήσετε πληροφορίες
  • Τα τιμολόγια έχουν 4 καταστάσεις: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Οι αλλαγές χρέωσης δεν είναι αναδρομικές στα υπάρχοντα τιμολόγια
  • Η xAI συνδυάζει προπληρωμένες πιστώσεις (κατά προτεραιότητα) και μηνιαία χρέωση
  • Η προεπισκόπηση χρεώσεων (invoice/preview) σας επιτρέπει να προβλέψετε το κόστος