Ülevaade
API kasutust saad vaadata kahel viisil:
Ava Analüütika > Kasutus, et vaadata API tegevust praeguse ja varasemate aruandeperioodide jooksul.
Üksiku päringu kontrollimiseks vaata API vastuses olevat kasutusteavet.
Playground kasutab samu API-kutseid nagu sinu rakendused. Selle tokenid arvestatakse sinu konto API kasutuse hulka ning neile kehtivad samad kasutusreeglid ja hinnad.
Juurdepääs juhtpaneelile
Kasutuse juhtpaneelile juurdepääsuks peate olema organisatsiooni omanik või teil peab olema õigus Kasutuse juhtpaneel.
Vaata kasutusandmeid töölaual
Praeguse projekti andmete vaatamiseks ava platvormil API Platform jaotis Analüütika ja vali Kasutus. Kogu organisatsiooni aruannete vaatamiseks vali Organisatsiooni analüütika. Vali aruandeperiood, mida soovid vaadata, ning kontrolli seda uuesti pärast projekti ja organisatsiooni analüütika vahel vahetamist.
Töölaua andmed kuvatakse UTC-ajas. Pea seda ajavööndit meeles, kui võrdled töölaual kuvatud tegevust oma rakenduse logidega.
Hiljutise kasutuse ilmumine töölauale võib võtta aega. Kui hiljutine tegevus puudub, kontrolli hiljem uuesti.
Filtreeri kasutusandmeid
Projekti jaotises Analüütika piirduvad kasutusandmed valitud projektiga. Jaotises Organisatsiooni analüütika vali menüüst Projekt projektid, mida soovid vaadata. Valik Kõik projektid hõlmab kõiki organisatsiooni projekte, arvestades muid valitud filtreid.
Kasuta jaotist Filtrid, et piirata kasutusandmeid valikute API allikad, API-võtmed, Mudelid, Kasutajad või Töötlustasand järgi. Menüüs API allikad saad valida Kõik API allikad, Agentide API või Otsene API.
Eemalda üksikud valikud või vali Tühjenda filtrid, et lähtestada paneel Filtrid. Filtrite tühjendamine ei vaheta projekti ja organisatsiooni analüütika vahel.
Kasuta graafikul Kasutus menüüd Filter, et filtreerida valiku Pakktöötlus järgi. Selle graafiku filtrite lähtestamiseks vali Lähtesta graafiku filtrid.
Kui funktsioon ei toeta valitud filtreid, ei pruugi selle väärtused olla saadaval. Puuduvad väärtused ei tähenda nullkasutust.
Kui filter kuvab õiguste vea, ei pruugi sul olla juurdepääsu selle valikutele. See ei tähenda, et kasutust pole registreeritud.
Vaata üksiku kasutaja kasutusandmeid
Ava soovitud projekti või organisatsiooni vaates Analüütika jaotis Kasutus. Vali tabelis API funktsioonid rea Vastused ja vestluse lõpetamised juures Vaata.
Vali jaotises Filtrid valik Kasutajad ja seejärel kasutaja. Tulemused värskendatakse kohe.
Vaata selle kasutaja graafikut ja tabelit.
Kasutaja andmete vaatamiseks kõigi funktsioonide lõikes rakenda ülevaates Kasutus filter Kasutajad. Kasutajate võrdlemiseks tühjenda see filter ja vali tabeli vahekaart Kasutajad.
Vaata tokenite arvu päeva, tunni või minuti kohta
Kui jaotises Kasutus saab ajavahemikku valida, vali 1 p või 1 t, et vaadata tokeneid päeva või tunni kaupa, või 1 min, et uurida tokenite arvu minutis (TPM). Vali Automaatne, et töölaud valiks sinu aruandeperioodile sobiva ajavahemiku. Need ajavahemikud kehtivad kasutusandmetele, mitte arveldusandmetele.
Kui 1 min pole valitav, vali lühem aruandeperiood või kasuta valikut Vali suurendamiseks ja lohista graafikul, et vahemikku kitsendada. Seejärel vali 1 min. Suurendusvaliku tühistamiseks vajuta klahvi Esc. Teise aruandeperioodi valimiseks vali jaotise Analüütika tööriistaribal praegune kuupäevavahemik.
Vaata kasutusgraafikuid ja -tabeleid
Vali menüüst Mõõdikud üks või mitu koos kuvatavat andmesarja, sealhulgas Sisendtokenid, Vahemällu salvestamata sisendtokenid, Vahemällu salvestatud sisendtokenid, Vahemällu kirjutatavad sisendtokenid, Sisendheli tokenid, Väljundtokenid ja Väljundheli tokenid. Saadaolevad mõõdikud sõltuvad funktsioonist. Iga andmesarja tuvastamiseks kasuta legendi.
Kasuta menüüd Rühmitamise alus, et korraldada kasutusandmeid kategooriate, näiteks Projekt, Kasutaja või Mudel järgi, kui need on saadaval. Filtrid määravad, millised kasutusandmed kaasatakse; rühmitamine määrab, kuidas neid kuvatakse. Trendide uurimiseks või kategooriate võrdlemiseks vaheta joongraafiku ja tulpdiagrammi vahel.
Vaata saadaolevaid jaotusi tabeli Kasutus vahekaartidel. Tabelites kuvatakse iga rea asjakohased näitajad, näiteks päringud, sisend- ja väljundtokenid või funktsioonipõhised ühikud.
Vali jaotises API funktsioonid soovitud funktsiooni juures Vaata, et avada selle üksikasjalikud graafikud ja jaotused. Jaotis Vastused ja vestluse lõpetamised sisaldab eraldi graafikuid Tokenid ja Päringud ning mõõdikut Mudelipäringud. Selle jaotusvahekaartidel kasutatakse samu mõõtmeid nagu ülevaates, kuid ilma vahekaardita API funktsioonid. Ülevaatesse naasmiseks vali asukoharibal Kasutus.
Pärast valiku tegemist menüüs Rühmitamise alus võidakse täiendavad kategooriad graafikul koondada kategooriasse Muu. Kui graafiku legendis kuvatakse Muu, vali selle silt, et näha kaasatud kategooriaid ja nende kasutusväärtusi.
Vali Võrdle töölaudu, et kuvada Kasutus kõrvuti teise töölauaga sama aruandeperioodi kohta. Vaadete valimiseks kasuta menüüsid Vasak töölaud ja Parem töölaud. Kui valitud ajavahemik pole töölauapaari jaoks saadaval, lülitub vaade režiimi Automaatne. Töölauale naasmiseks vali Välju võrdlusest.
Uuri tundmatut kasutust
Kui jaotises Kasutus kuvatakse tegevust, mida sa ei saa seostada rakenduse logides olevate päringutega, tee järgmised kontrollid.
Kontrolli organisatsiooni, kaasatud projekte ja aruandeperioodi. Töölaua ajatemplite võrdlemisel rakenduse logidega kasuta UTC-aega.
Ava asjaomase projekti vaade või vali see jaotise Organisatsiooni analüütika menüüst Projekt. Seejärel piira jaotises Filtrid kasutusandmeid API-võtme ja mudeli järgi ning vali lühem aruandeperiood.
Võrdle tegevust sama perioodi, projekti ja API-võtme logidega. Kontrolli, kas logid hõlmavad kõiki seda võtit kasutavaid rakendusi ja integratsioone.
Kui mitu rakendust või integratsiooni jagavad sama projekti või API-võtit, ei pruugi ainuüksi kogusumma näidata, milline neist päringu saatis. Võrdle töölaua andmeid iga rakenduse kirjetega sama UTC-perioodi kohta.
Kui sa endiselt ei leia kasutusele selgitust, võta ühendust OpenAI toega ning lisa asjaomane UTC-periood, organisatsiooni ja projekti ID-d, API-võtme identifikaator ning asjakohased kuvatõmmised või logid. Lisa päringute ID-d, kui need on saadaval. Ära lisa salajasi API-võtmeid.
Ekspordi kasutusandmed
Kasutusandmete eksportimiseks vali jaotise Analüütika tööriistaribal ikoon Ekspordi CSV ja seejärel Tegevusandmed.
Vali API funktsioon ning menüüst Rühmitamise alus üks või mitu mõõdet.
Vaata üle valikud API allikas, Projektid, Kasutajad, API-võtmed ja Mudelid. Projektid ja API allikas on eelvalitud jaotise Analüütika põhjal; muud ekspordifiltrid vali dialoogiaknas.
Määra Failivorming, Algusaeg, Lõppaeg ja Ajavahemik ning vali seejärel Laadi alla. Kuupäevad hõlmavad terveid UTC-päevi.
Tegevus- ja kuluandmeid saab vaadata ning eksportida alates ühe kalendriaasta tagusest kuupäevast kell 00.00 UTC kuni tänaseni. Vanemate andmete saamiseks võta ühendust OpenAI toega. Päevapõhised andmed eksporditakse failidesse 31-päevaste perioodide kaupa.
Igakuiste arvete võrdlemise ja arveridade eksportimise kohta loe artiklist Igakuiste kasutusandmete eksportimine.
Kui tegevusandmete eksport sisaldab negatiivseid ridu, võrdle ridu, millel on sama ühik, rühmitus ja kuupäevad. Arveldatud summade vaatamiseks kasuta valikut Kuluandmed. Ainuüksi negatiivne tegevusrida ei tõenda, et sinu arvet on krediteeritud.
Vaata kulusid
Praeguse projekti kulude vaatamiseks ava Analüütika ja vali Kulud. Kogu organisatsiooni kulude vaatamiseks vali Organisatsiooni analüütika ja seejärel Kulud.
Enne kulude võrdlemist kasutusega kontrolli praegust kuupäevavahemikku ja filtreid. Töölaudadel Kasutus ja Kulud on erinevad filtrid; ühel töölaual saadaolev filter ei pruugi teisele kehtida.
Kuluandmete piiramiseks kasuta filtreid API allikad, API-võtmed, Mudelid ja Arveread. Organisatsiooni analüütikas vali menüüst Projekt projektid, mille andmeid soovid vaadata. Saadaolevate jaotuste vaatamiseks kasuta tabeli vahekaarte Arveread, API-võtmed, Kasutajad, Projektid ja Mudelid.
Puuduv kululimiidi väärtus ei tähenda, et sinu limiit on null või et on rakendatud uus limiit. Juurdepääsuõigused, määramata limiit või nurjunud päring võivad takistada väärtuse kuvamist töölaual.
Vaata teenuse seisundit
Kui sinu organisatsioonil on juurdepääs töölauale Teenuse seisund, ava see jaotises Analüütika, et vaadata API jõudlust. Juurdepääsutingimuste ja mõõdikute määratluste kohta loe artiklist API vigade ja latentsuse tõrkeotsing.
Vaata eraldatud krediite
Eraldatud krediitide üksikasjad leiad oma organisatsiooni arvelduslehelt.
Eraldatud krediidid ja API kasutus annavad erinevat teavet: eraldatud krediidid näitavad sinu organisatsiooniga seotud krediite, kasutus aga selle API tegevust.
Skaleerimistasandi kasutuse ja kulude vaatamine
Kui teie organisatsioonis on Skaleerimistasand lubatud ja teil on vajalik juurdepääs, avage üksikasjalike kasutusandmete vaatamiseks Skaleerimistasandi kasutuse leht.
Skaleerimistasandi pakettide kulud omistatakse organisatsioonile, mitte üksikutele projektidele.
Kasutus on suurem kui null, kuid projekti kulu on null
Kontrolli, kas mudeli kasutus on kaetud sinu Skaleerimistasandi mahuga. Kui selle mudeli kogu kasutus jääb Skaleerimistasandi eraldatud TPM-mahu piiresse, võib projektis olla kasutust ilma täiendava mudelikuluta.
Skaleerimistasandi tellimuse kulu jääb organisatsiooni tasemele. Vaata kogu organisatsiooni kulusid, mitte ära lähtu üksnes ühe projekti kuludest.
Vaata mitme organisatsiooni andmeid
Kasutuse töölaud ei koonda eri organisatsioonide kulu- ega kasutusandmeid. Iga organisatsiooni, sealhulgas allorganisatsiooni, käsitletakse eraldi.
Allorganisatsiooni vaatamiseks vali see organisatsiooni valikumenüüst.
Kui vajad koondaruandlust, kaalu eraldi allorganisatsioonide asemel ühe organisatsiooni projektide kasutamist või kasuta kohandatud analüüsiks kasutuse API-t.
Kontrolli tokenikasutust API vastuses
Tokenikasutuse väljade nimed sõltuvad lõpp-punktist.
| Tokenite arv | Vestluse lõpetamised | Vastused |
|---|---|---|
| Sisendtokenid | usage.prompt_tokens | usage.input_tokens |
| Väljundtokenid | usage.completion_tokens | usage.output_tokens |
| Tokeneid kokku | usage.total_tokens | usage.total_tokens |
Vestluse lõpetamise vastused võivad sisaldada tokenikasutuse teavet. Näited:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Olenevalt lõpp-punktist ja mudelist võivad üksikasjalikud kasutusandmed sisaldada ka vahemällu salvestatud sisendtokenite ja arutlustokenite arvu. Need aitavad selgitada, miks vastuse nähtav pikkus ei kajasta selle kogu tokenikasutust.
Eri tokenikategooriate selgitusi leiad artiklist Tokenite mõistmine ja loendamine.
Tokenikasutust kajastavas transkriptsioonivastuses sisalduvad heli- ja tekstisisendi tokenid juba väljal input_tokens. Ära lisa neid sisendtokenite koguarvule uuesti. Võrdle välja output_tokens väärtusi eraldi.
Kasutusandmete hankimine Chat Completionsi voogedastusest
Chat Completionsi voogedastusega päringusse lisa:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Kui include_usage on lubatud, sisaldab lisaplokk enne data: [DONE] kogu päringu kasutusandmeid. Selle choices-massiiv on tühi. Teistes plokkides on välja usage väärtus null.
Kui voogedastus katkeb, ei pruugi sa seda viimast kasutusandmete plokki saada. Viimase ploki puudumine ei tõenda, et päring ei kasutanud ühtegi tokenit.
See seadistus kehtib ainult Chat Completionsi puhul. Lisateavet leiad vestluse lõpetamise API teatmikust.