OpenAI
Αυτή η σελίδα μεταφράστηκε αυτόματα. Δείτε το πρωτότυπο άρθρο στα αγγλικά.

Έλεγχος χρήσης και κόστους API

Δείτε τη δραστηριότητα API στα Αναλυτικά στοιχεία, ελέγξτε τον αριθμό token στις αποκρίσεις API και κατανοήστε τα φίλτρα έργων, τις εξαγωγές και το κόστος του Επιπέδου κλιμάκωσης.

Τελευταία ενημέρωση: yesterday

Επισκόπηση

Μπορείτε να εξετάσετε τη χρήση API με δύο τρόπους:

  • Χρησιμοποιήστε τη διαδρομή Αναλυτικά στοιχεία > Χρήση για να εξετάσετε τη δραστηριότητα API στην τρέχουσα και σε παλαιότερες περιόδους αναφοράς.

  • Διαβάστε τις πληροφορίες χρήσης σε μια απόκριση API για να ελέγξετε ένα μεμονωμένο αίτημα.

Το Playground χρησιμοποιεί τις ίδιες κλήσεις API με τις εφαρμογές σας. Τα token του συνυπολογίζονται στη χρήση API του λογαριασμού σας και υπόκεινται στους ίδιους κανόνες χρήσης και στην ίδια τιμολόγηση.

Πρόσβαση στον πίνακα ελέγχου

Για να αποκτήσετε πρόσβαση στον Πίνακα ελέγχου χρήσης, πρέπει να είστε κάτοχος του οργανισμού ή να έχετε την άδεια Πίνακας ελέγχου χρήσης.

Εξετάστε τη χρήση στον πίνακα ελέγχου

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

Τα δεδομένα του πίνακα ελέγχου εμφανίζονται σε UTC. Λάβετε υπόψη αυτή τη ζώνη ώρας όταν συγκρίνετε τη δραστηριότητα στον πίνακα ελέγχου με τα αρχεία καταγραφής της εφαρμογής σας.

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

Φιλτράρετε τα δεδομένα χρήσης

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

Χρησιμοποιήστε τα Φίλτρα για να περιορίσετε τα δεδομένα χρήσης με βάση τις Πηγές API, τα Κλειδιά API, τα Μοντέλα, τους Χρήστες ή το Επίπεδο επεξεργασίας. Η επιλογή Πηγές API σάς επιτρέπει να επιλέξετε Όλες οι πηγές API, Agents API ή Άμεσο API.

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

Χρησιμοποιήστε την επιλογή Φίλτρο στο γράφημα Χρήση για να φιλτράρετε κατά Παρτίδα. Επιλέξτε Επαναφορά φίλτρων γραφήματος για να επαναφέρετε τα φίλτρα του συγκεκριμένου γραφήματος.

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

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

Εξετάστε τη χρήση ενός μεμονωμένου χρήστη

  1. Ανοίξτε τη Χρήση στην προβολή Αναλυτικά στοιχεία του έργου ή του οργανισμού που θέλετε να εξετάσετε. Στον πίνακα Δυνατότητες API, επιλέξτε Προβολή για την επιλογή Αποκρίσεις και συμπληρώσεις συνομιλίας.

  2. Στα Φίλτρα, επιλέξτε Χρήστες και επιλέξτε τον χρήστη. Τα αποτελέσματα ενημερώνονται αμέσως.

  3. Εξετάστε το γράφημα και τον πίνακα για τον συγκεκριμένο χρήστη.

Για να εξετάσετε τη χρήση ενός χρήστη σε όλες τις δυνατότητες, εφαρμόστε το φίλτρο Χρήστες στην επισκόπηση Χρήση. Για να συγκρίνετε χρήστες, καταργήστε αυτό το φίλτρο και επιλέξτε την καρτέλα Χρήστες του πίνακα.

Δείτε τα token ανά ημέρα, ώρα ή λεπτό

Όπου διατίθενται επιλογές χρονικού διαστήματος στη Χρήση, επιλέξτε 1 ημ. ή 1 ώρα για να δείτε τα token ανά ημέρα ή ώρα, ή 1 λεπ. για να εξετάσετε τα token ανά λεπτό (TPM). Επιλέξτε Αυτόματο για να αφήσετε τον πίνακα ελέγχου να επιλέξει το χρονικό διάστημα για την περίοδο αναφοράς σας. Αυτά τα διαστήματα ισχύουν για τα δεδομένα χρήσης, όχι για τα δεδομένα χρέωσης.

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

Εξετάστε γραφήματα και πίνακες χρήσης

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

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

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

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

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

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

Διερευνήστε χρήση που δεν αναγνωρίζετε

Αν η Χρήση εμφανίζει δραστηριότητα που δεν μπορείτε να αντιστοιχίσετε σε αιτήματα στα αρχεία καταγραφής της εφαρμογής σας, κάντε τους εξής ελέγχους:

  1. Επιβεβαιώστε τον οργανισμό, τα έργα που περιλαμβάνονται και την περίοδο αναφοράς. Χρησιμοποιήστε τη ζώνη ώρας UTC όταν συγκρίνετε τις χρονικές σημάνσεις του πίνακα ελέγχου με τα αρχεία καταγραφής της εφαρμογής σας.

  2. Χρησιμοποιήστε την προβολή έργου για το επηρεαζόμενο έργο ή επιλέξτε το από την επιλογή Έργο στα Αναλυτικά στοιχεία οργανισμού. Στη συνέχεια, χρησιμοποιήστε τα Φίλτρα για να περιορίσετε τα δεδομένα χρήσης ανά κλειδί API και μοντέλο και επιλέξτε μικρότερη περίοδο αναφοράς.

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

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

  5. Αν εξακολουθείτε να μην μπορείτε να εξηγήσετε τη χρήση, επικοινωνήστε με την Υποστήριξη της OpenAI, παρέχοντας την επηρεαζόμενη περίοδο σε UTC, τα αναγνωριστικά οργανισμού και έργου, το αναγνωριστικό του κλειδιού API και σχετικά στιγμιότυπα οθόνης ή αρχεία καταγραφής. Συμπεριλάβετε αναγνωριστικά αιτημάτων, αν είναι διαθέσιμα. Μη συμπεριλάβετε μυστικά κλειδιά API.

Εξαγάγετε δεδομένα χρήσης

Για να εξαγάγετε δεδομένα χρήσης, επιλέξτε το εικονίδιο Εξαγωγή CSV στη γραμμή εργαλείων Αναλυτικά στοιχεία και, στη συνέχεια, επιλέξτε Δεδομένα δραστηριότητας.

  1. Επιλέξτε τη Δυνατότητα API και μία ή περισσότερες διαστάσεις στην επιλογή Ομαδοποίηση κατά.

  2. Ελέγξτε τις επιλογές Πηγή API, Έργα, Χρήστες, Κλειδιά API και Μοντέλα. Οι επιλογές Έργα και Πηγή API είναι προεπιλεγμένες με βάση τα Αναλυτικά στοιχεία· επιλέξτε τα υπόλοιπα φίλτρα εξαγωγής στο παράθυρο διαλόγου.

  3. Επιλέξτε Μορφή αρχείου, Ώρα έναρξης, Ώρα λήξης και Χρονικό διάστημα και, στη συνέχεια, επιλέξτε Λήψη. Οι ημερομηνίες περιλαμβάνουν ολόκληρες ημέρες σε UTC.

Τα δεδομένα δραστηριότητας και κόστους είναι διαθέσιμα για προβολή και εξαγωγή από τις 00:00 UTC της αντίστοιχης ημερομηνίας πριν από ένα ημερολογιακό έτος έως σήμερα. Για παλαιότερα δεδομένα, επικοινωνήστε με την Υποστήριξη της OpenAI. Τα ημερήσια δεδομένα εξάγονται σε αρχεία που καλύπτουν διαδοχικά διαστήματα 31 ημερών.

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

Αν μια εξαγωγή δραστηριότητας περιλαμβάνει γραμμές με αρνητικές τιμές, συγκρίνετε γραμμές με την ίδια μονάδα, ομαδοποίηση και ημερομηνίες. Χρησιμοποιήστε τα Δεδομένα κόστους για τα τιμολογημένα ποσά. Μια γραμμή δραστηριότητας με αρνητική τιμή δεν αποδεικνύει από μόνη της ότι έγινε πίστωση στο τιμολόγιό σας.

Εξετάστε τη δαπάνη

Ανοίξτε τα Αναλυτικά στοιχεία και επιλέξτε Δαπάνη για να εξετάσετε το κόστος του τρέχοντος έργου. Για το κόστος ολόκληρου του οργανισμού, επιλέξτε Αναλυτικά στοιχεία οργανισμού και, στη συνέχεια, Δαπάνη.

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

Χρησιμοποιήστε τις επιλογές Πηγές API, Κλειδιά API, Μοντέλα και Επιμέρους χρεώσεις για να περιορίσετε τα δεδομένα δαπάνης. Στα αναλυτικά στοιχεία οργανισμού, χρησιμοποιήστε την επιλογή Έργο για να συμπεριλάβετε τα έργα που θέλετε να εξετάσετε. Χρησιμοποιήστε τις καρτέλες Επιμέρους χρεώσεις, Κλειδιά API, Χρήστες, Έργα και Μοντέλα του πίνακα για τις διαθέσιμες αναλύσεις.

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

Εξετάστε την κατάσταση λειτουργίας της υπηρεσίας

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

Δείτε τις χορηγήσεις μονάδων

Οι λεπτομέρειες των χορηγήσεων μονάδων είναι διαθέσιμες στη σελίδα Χρέωση του οργανισμού σας.

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

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

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

Το κόστος των πακέτων του Επιπέδου κλιμάκωσης καταλογίζεται στον οργανισμό και όχι σε μεμονωμένα έργα.

Η χρήση είναι μεγαλύτερη από το μηδέν, αλλά η δαπάνη του έργου είναι μηδενική

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

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

Εξετάστε πολλούς οργανισμούς

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

Για να δείτε έναν υποοργανισμό, επιλέξτε τον στον επιλογέα οργανισμού.

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

Ελέγξτε τη χρήση token σε μια απόκριση API

Τα ονόματα των πεδίων χρήσης token εξαρτώνται από το τελικό σημείο.

Αριθμός tokenChat CompletionsResponses
Token εισόδουusage.prompt_tokensusage.input_tokens
Token εξόδουusage.completion_tokensusage.output_tokens
Σύνολο tokenusage.total_tokensusage.total_tokens

Οι αποκρίσεις του Chat Completions μπορούν να περιλαμβάνουν πληροφορίες για τη χρήση token. Ενδεικτικά παραδείγματα:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

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

Για μια εξήγηση των διαφορετικών κατηγοριών token, δείτε: Κατανόηση και καταμέτρηση των token.

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

Λήψη στοιχείων χρήσης από το Chat Completions σε ροή

Για ένα αίτημα Chat Completions με απόκριση σε ροή, συμπεριλάβετε:

{
"stream": true,
"stream_options": {
"include_usage": true
}
}

Όταν το include_usage είναι ενεργοποιημένο, ένα επιπλέον τμήμα πριν από το data: [DONE] περιέχει τα στοιχεία χρήσης για ολόκληρο το αίτημα. Ο πίνακας choices αυτού του τμήματος είναι κενός. Στα υπόλοιπα τμήματα, το πεδίο usage έχει τιμή null.

Αν διακοπεί η ροή, ενδέχεται να μη λάβετε αυτό το τελικό τμήμα με τα στοιχεία χρήσης. Η απουσία του τελικού τμήματος δεν αποδεικνύει ότι το αίτημα δεν χρησιμοποίησε token.

Αυτή η ρύθμιση ισχύει μόνο για το Chat Completions. Για λεπτομέρειες, δείτε την τεκμηρίωση αναφοράς του Chat Completions API.

Σας βοήθησε αυτό το άρθρο;