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

Ανάλυση Χρήσης

Μάθημα 9 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Κατανοήστε την Κατανάλωση του API σας
  2. Endpoint Ανάλυσης
  3. Παράμετροι Αιτήματος
  4. Πρακτικά Παραδείγματα
  5. Βασικά σημεία

Κατανοήστε την Κατανάλωση του API σας

Πίνακας ελέγχου χρήσης στην κονσόλα xAI Ένα τιμολόγιο σας λέει πόσα ξοδέψατε· αυτό το endpoint σας λέει γιατί. Αυτή είναι η διαφορά μεταξύ της παρατήρησης και της δράσης: η κατανάλωση αναλύεται ανά μοντέλο, ανά χρονική περίοδο και με τη λεπτομέρεια που εσείς επιλέγετε, επιτρέποντάς σας να συνδέσετε μια απότομη αύξηση με ένα συγκεκριμένο μοντέλο σε μια συγκεκριμένη χρονική στιγμή.

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

7
Χρονικές Μονάδες
9
Συσσωρεύσεις
POST
Μέθοδος HTTP
groupBy
Ανάλυση ανά Μοντέλο

Endpoint Ανάλυσης

Η ανάλυση χρήσης πραγματοποιείται μέσω ενός αιτήματος POST:

POST /v1/billing/teams/{teamId}/usage

Δομή Αιτήματος

{
  "analyticsRequest": {
    "timeRange": {
      "startTime": "2026-03-01 00:00:00",
      "endTime": "2026-04-01 00:00:00",
      "timezone": "UTC"
    },
    "timeUnit": "DAY",
    "values": [
      {"name": "tokens", "aggregation": "SUM"}
    ],
    "groupBy": ["model"]
  }
}

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

Παράμετροι Αιτήματος

timeRange

Ορίζει την περίοδο ανάλυσης:

  • startTime : αρχή της περιόδου (μορφή YYYY-MM-DD HH:MM:SS)
  • endTime : τέλος της περιόδου (ίδια μορφή)
  • timezone : ζώνη ώρας για την ερμηνεία των ημερομηνιών (π.χ. UTC, Europe/Paris)

timeUnit

Η χρονική λεπτομέρεια των αποτελεσμάτων. Οι διαθέσιμες επιλογές είναι:

  • MONTH : μηνιαία συσσώρευση
  • CALENDAR_WEEK : συσσώρευση ανά ημερολογιακή εβδομάδα
  • DAY : ημερήσια συσσώρευση
  • HOUR : ωριαία συσσώρευση
  • QUARTER_HOUR : συσσώρευση ανά δεκαπεντάλεπτο
  • MINUTE : συσσώρευση ανά λεπτό
  • SECOND : συσσώρευση ανά δευτερόλεπτο

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

values

Η επιλογή της συνάρτησης συσσώρευσης αλλάζει το ερώτημα που τίθεται, και εδώ είναι που τα εκατοστημόρια αξίζουν την προσοχή σας. Το AVG στον χρόνο απόκρισης (latency) δίνει έναν καθησυχαστικό μέσο όρο που κανείς στην πραγματικότητα δεν βιώνει· το P99 δίνει τον χρόνο αναμονής που endured οι πιο «άτυχοι» χρήστες σας—αυτοί που παραπονιούνται. Για το κόστος, χρησιμοποιήστε SUM· για την απόδοση, χρησιμοποιήστε ένα εκατοστημόριο.

"values": [
  {"name": "tokens", "aggregation": "SUM"},
  {"name": "tokens", "aggregation": "AVG"},
  {"name": "latency", "aggregation": "P99"}
]

Διαθέσιμες συναρτήσεις συσσώρευσης:

  • SUM : συνολικό άθροισμα
  • AVG : μέσος όρος
  • MIN : ελάχιστη τιμή
  • MAX : μέγιστη τιμή
  • P50 : διάμεσος (50ό εκατοστημόριο)
  • P90 : 90ό εκατοστημόριο
  • P99 : 99ό εκατοστημόριο
  • COUNT : αριθμός εμφανίσεων
  • COUNT_DISTINCT : αριθμός διακριτών τιμών

groupBy

Διαχωρίζει τα αποτελέσματα ανά διάσταση. Επί του παρόντος, διατίθεται ομαδοποίηση ανά model, επιτρέποντάς σας να δείτε την ξεχωριστή κατανάλωση για κάθε μοντέλο (grok-4.20-0309-reasoning, grok-4.3, κ.λπ.).

Πρακτικά Παραδείγματα

Ημερήσια Κατανάλωση για τον Τρέχοντα Μήνα

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-04-01 00:00:00",
        "endTime": "2026-05-01 00:00:00",
        "timezone": "Europe/Paris"
      },
      "timeUnit": "DAY",
      "values": [{"name": "tokens", "aggregation": "SUM"}],
      "groupBy": ["model"]
    }
  }'

Αριθμός Αιτημάτων ανά Ώρα

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-04-03 00:00:00",
        "endTime": "2026-04-04 00:00:00",
        "timezone": "Europe/Paris"
      },
      "timeUnit": "HOUR",
      "values": [{"name": "requests", "aggregation": "COUNT"}],
      "groupBy": ["model"]
    }
  }'

Χρόνος Απόκρισης P99 ανά Μοντέλο

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-04-01 00:00:00",
        "endTime": "2026-04-04 00:00:00",
        "timezone": "UTC"
      },
      "timeUnit": "DAY",
      "values": [
        {"name": "latency", "aggregation": "P99"},
        {"name": "latency", "aggregation": "AVG"}
      ],
      "groupBy": ["model"]
    }
  }'

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

  • Το endpoint POST /v1/billing/teams/{teamId}/usage συγκεντρώνει όλες τις αναλύσεις
  • 7 διαθέσιμες χρονικές διαβαθμίσεις, από το SECOND έως το MONTH
  • 9 συναρτήσεις συσσώρευσης: SUM, AVG, MIN, MAX, P50, P90, P99, COUNT, COUNT_DISTINCT
  • Η παράμετρος groupBy: ["model"] διαχωρίζει τα αποτελέσματα ανά μοντέλο
  • Χρησιμοποιήστε τη ζώνη ώρας Europe/Paris για αναφορές ευθυγραμμισμένες με το ωράριο εργασίας σας