OpenAI
Kjo faqe u përkthye automatikisht. Shih artikullin origjinal në anglisht.

Shqyrtimi i përdorimit dhe kostove të API-së

Shqyrtoni aktivitetin e API-së te Analitika, kontrolloni numrin e tokenëve në përgjigjet e API-së dhe kuptoni filtrat e projekteve, eksportet dhe kostot e nivelit të shkallëzimit.

Përditësuar: yesterday

Përmbledhje

Mund ta shqyrtoni përdorimin e API-së në dy mënyra:

  • Përdorni Analitika > Përdorimi për të shqyrtuar aktivitetin e API-së në periudhat aktuale dhe të kaluara të raportimit.

  • Lexoni informacionin e përdorimit në një përgjigje të API-së për të kontrolluar një kërkesë të veçantë.

Playground përdor të njëjtat thirrje API si aplikacionet tuaja. Tokenët e tij llogariten në përdorimin e API-së të llogarisë suaj dhe u nënshtrohen të njëjtave rregulla përdorimi dhe çmime.

Qasja në panel

Për të pasur qasje në Panelin e përdorimit, duhet të jeni pronar i organizatës ose të keni lejen Paneli i përdorimit.

Shqyrtoni përdorimin në panel

Në Platformën API, hapni Analitika dhe zgjidhni Përdorimi për të shqyrtuar projektin aktual. Për raportim në nivel të gjithë organizatës, zgjidhni Analitika e organizatës. Zgjidhni periudhën e raportimit që dëshironi të shqyrtoni dhe kontrollojeni sërish pasi të kaloni midis analitikës së projektit dhe asaj të organizatës.

Të dhënat e panelit shfaqen sipas UTC-së. Mbajeni parasysh këtë zonë kohore kur krahasoni aktivitetin e panelit me regjistrat e aplikacionit tuaj.

Mund të duhet pak kohë që përdorimi i fundit të shfaqet në panel. Nëse aktiviteti i fundit mungon, kontrolloni sërish më vonë.

Filtroni përdorimin

Te Analitika e projektit, përdorimi kufizohet te projekti i zgjedhur. Te Analitika e organizatës, përdorni Projekti për të zgjedhur projektet që dëshironi të shqyrtoni. Të gjitha projektet përfshin çdo projekt në organizatë, duke zbatuar edhe filtrat e tjerë që keni zgjedhur.

Përdorni Filtrat për ta kufizuar përdorimin sipas Burimeve të API-së, Çelësave API, Modeleve, Përdoruesve ose Nivelit të përpunimit. Burimet e API-së ju lejon të zgjidhni Të gjitha burimet e API-së, API-ja e agjentëve ose API-ja e drejtpërdrejtë.

Hiqni përzgjedhje të veçanta ose zgjidhni Pastro filtrat për të rivendosur panelin Filtrat. Pastrimi i filtrave nuk ju kalon nga analitika e projektit tek ajo e organizatës ose anasjelltas.

Përdorni Filtro në grafikun Përdorimi për të filtruar sipas Grupit. Zgjidhni Rivendos filtrat e grafikut për të rivendosur filtrat e atij grafiku.

Nëse një funksionalitet nuk i mbështet filtrat e zgjedhur, vlerat e tij mund të mos jenë të disponueshme. Vlerat e padisponueshme nuk nënkuptojnë përdorim zero.

Nëse një filtër shfaq një gabim lejesh, mund të mos keni qasje te opsionet e tij. Kjo nuk do të thotë se nuk është regjistruar përdorim.

Shqyrtoni përdorimin e një përdoruesi të veçantë

  1. Hapni Përdorimi në pamjen Analitika të projektit ose organizatës që dëshironi të shqyrtoni. Në tabelën Funksionalitetet e API-së, zgjidhni Shiko për Përgjigjet dhe përfundimet e bisedës.

  2. Te Filtrat, zgjidhni Përdoruesit dhe zgjidhni përdoruesin. Rezultatet përditësohen menjëherë.

  3. Shqyrtoni grafikun dhe tabelën për atë përdorues.

Për të shqyrtuar përdorimin e një përdoruesi në funksionalitete të ndryshme, zbatoni filtrin Përdoruesit në pamjen e përgjithshme të Përdorimit. Për të krahasuar përdoruesit, pastroni atë filtër dhe zgjidhni skedën Përdoruesit të tabelës.

Shikoni tokenët sipas ditës, orës ose minutës

Kur kontrollet e intervalit janë të disponueshme te Përdorimi, zgjidhni 1d ose 1h për të parë tokenët sipas ditës ose orës, ose 1m për të shqyrtuar tokenët për minutë (TPM). Zgjidhni Automatik që paneli të zgjedhë intervalin kohor për periudhën tuaj të raportimit. Këto intervale zbatohen për të dhënat e përdorimit, jo për të dhënat e faturimit.

Nëse 1m është çaktivizuar, zgjidhni një periudhë më të shkurtër raportimi ose përdorni Përzgjidh për zmadhim dhe tërhiqni treguesin nëpër grafik për ta ngushtuar periudhën. Më pas zgjidhni 1m. Shtypni Esc për të anuluar një përzgjedhje për zmadhim. Zgjidhni intervalin aktual të datave në shiritin e veglave të Analitikës për të zgjedhur një periudhë tjetër raportimi.

Shqyrtoni grafikët dhe tabelat e përdorimit

Përdorni Metrikat për të zgjedhur një ose më shumë seri që të shfaqen së bashku, përfshirë Tokenët hyrës, Tokenët hyrës të paruajtur në cache, Tokenët hyrës të ruajtur në cache, Tokenët hyrës për shkrim në cache, Tokenët hyrës të audios, Tokenët dalës dhe Tokenët dalës të audios. Metrikat e disponueshme varen nga funksionaliteti. Përdorni legjendën për të identifikuar secilën seri.

Përdorni Grupo sipas për ta organizuar përdorimin sipas kategorive si Projekti, Përdoruesi ose Modeli, kur janë të disponueshme. Filtrat përcaktojnë cilat të dhëna përdorimi përfshihen; grupimi përcakton si shfaqen ato. Kaloni midis grafikëve me vija dhe atyre me shtylla për të shqyrtuar prirjet ose për të krahasuar kategoritë.

Përdorni skedat e tabelës Përdorimi për të shqyrtuar ndarjet e disponueshme të të dhënave. Tabelat tregojnë matjet përkatëse për çdo rresht, si kërkesat, tokenët hyrës dhe dalës ose njësitë specifike të funksionalitetit.

Te Funksionalitetet e API-së, zgjidhni Shiko për një funksionalitet që të hapni grafikët dhe ndarjet e tij të hollësishme. Përgjigjet dhe përfundimet e bisedës përfshin grafikë të veçantë për Tokenët dhe Kërkesat, si dhe metrikën Kërkesat për modelin. Skedat e ndarjes së të dhënave përdorin të njëjtat dimensione si pamja e përgjithshme, pa skedën Funksionalitetet e API-së. Përdorni lidhjen Përdorimi në shtegun e navigimit për t’u kthyer te pamja e përgjithshme.

Pasi të zgjidhni një opsion te Grupo sipas, grafiku mund t’i bashkojë kategoritë shtesë te Të tjera. Nëse Të tjera shfaqet në legjendën e grafikut, zgjidhni etiketën e saj për të parë kategoritë e përfshira dhe vlerat e tyre të përdorimit.

Zgjidhni Krahaso panelet për të parë Përdorimi krah një paneli tjetër për të njëjtën periudhë raportimi. Përdorni Paneli majtas dhe Paneli djathtas për të zgjedhur pamjet. Nëse intervali kohor i zgjedhur nuk është i disponueshëm për çiftin e paneleve, pamja kalon te Automatik. Zgjidhni Dil nga krahasimi për t’u kthyer te paneli.

Hetoni përdorimin që nuk e njihni

Nëse Përdorimi tregon aktivitet që nuk mund ta lidhni me kërkesat në regjistrat e aplikacionit tuaj, kryeni këto kontrolle:

  1. Konfirmoni organizatën, projektet e përfshira dhe periudhën e raportimit. Përdorni UTC kur krahasoni vulat kohore të panelit me regjistrat e aplikacionit tuaj.

  2. Përdorni pamjen e projektit për projektin në fjalë, ose zgjidheni te Projekti në Analitika e organizatës. Më pas përdorni Filtrat për ta kufizuar përdorimin sipas çelësit API dhe modelit dhe zgjidhni një periudhë më të shkurtër raportimi.

  3. Krahasoni aktivitetin me regjistrat për të njëjtën periudhë, projekt dhe çelës API. Kontrolloni nëse regjistrat tuaj mbulojnë të gjitha aplikacionet ose integrimet që përdorin atë çelës.

  4. Nëse disa aplikacione ose integrime ndajnë të njëjtin projekt ose çelës API, vetëm totali mund të mos mjaftojë për të identifikuar se cili prej tyre ka dërguar një kërkesë. Krahasoni panelin me regjistrat nga çdo aplikacion për të njëjtën periudhë UTC.

  5. Nëse ende nuk mund ta shpjegoni përdorimin, kontaktoni mbështetjen e OpenAI duke dhënë periudhën përkatëse në UTC, ID-të e organizatës dhe projektit, identifikuesin e çelësit API dhe pamjet e ekranit ose regjistrat përkatës. Përfshini ID-të e kërkesave, nëse janë të disponueshme. Mos përfshini çelësa sekretë API.

Eksportoni të dhënat e përdorimit

Për të eksportuar të dhënat e përdorimit, zgjidhni ikonën Eksporto CSV në shiritin e veglave të Analitikës, pastaj zgjidhni Të dhënat e aktivitetit.

  1. Zgjidhni Funksionaliteti i API-së dhe një ose më shumë dimensione te Grupo sipas.

  2. Shqyrtoni Burimi i API-së, Projektet, Përdoruesit, Çelësat API dhe Modelet. Projektet dhe Burimi i API-së janë të parazgjedhura nga Analitika; zgjidhni filtrat e tjerë të eksportit në kutinë e dialogut.

  3. Zgjidhni Formati i skedarit, Koha e fillimit, Koha e përfundimit dhe Intervali kohor, pastaj zgjidhni Shkarko. Datat përfshijnë ditë të plota sipas UTC-së.

Të dhënat e aktivitetit dhe kostove mund të shihen dhe eksportohen për periudhën nga ora 00:00 UTC e datës së një viti kalendarik më parë deri më sot. Për të dhëna më të hershme, kontaktoni mbështetjen e OpenAI. Të dhënat ditore eksportohen në skedarë që mbulojnë periudha 31-ditore.

Për rakordimin e faturave mujore dhe eksportimin e zërave të faturës, shihni: Eksportimi i hollësive të përdorimit mujor.

Nëse një eksport i aktivitetit përfshin rreshta me vlera negative, krahasoni rreshtat me të njëjtën njësi, grupim dhe data. Përdorni Të dhënat e kostove për shumat e faturuara. Një rresht aktiviteti me vlerë negative, i vetëm, nuk vërteton se është bërë një kreditim në faturën tuaj.

Shqyrtoni shpenzimet

Hapni Analitika dhe zgjidhni Shpenzimet për të shqyrtuar kostot e projektit aktual. Për kostot e të gjithë organizatës, zgjidhni Analitika e organizatës dhe më pas Shpenzimet.

Kontrolloni intervalin aktual të datave dhe filtrat përpara se të krahasoni kostot me përdorimin. Përdorimi dhe Shpenzimet ofrojnë filtra të ndryshëm; një filtër i disponueshëm në njërin panel mund të mos zbatohet në tjetrin.

Përdorni Burimet e API-së, Çelësat API, Modelet dhe Zërat e faturës për të kufizuar shpenzimet që shfaqen. Në analitikën e organizatës, përdorni Projekti për të përfshirë projektet që dëshironi të shqyrtoni. Përdorni skedat Zërat e faturës, Çelësat API, Përdoruesit, Projektet dhe Modelet të tabelës për ndarjet e disponueshme të të dhënave.

Një vlerë e padisponueshme e kufirit të shpenzimeve nuk do të thotë se kufiri juaj është zero ose se është zbatuar një kufi i ri. Lejet e qasjes, një kufi i pacaktuar ose një kërkesë e dështuar mund ta pengojnë panelin të shfaqë një vlerë.

Shqyrtoni gjendjen e shërbimit

Nëse organizata juaj ka qasje te Gjendja e shërbimit, hapeni atë panel te Analitika për të shqyrtuar performancën e API-së. Për kriteret e qasjes dhe përkufizimet e metrikave, shihni: Zgjidhja e gabimeve dhe vonesave të API-së.

Shikoni kreditet e dhëna

Hollësitë e krediteve të dhëna gjenden në faqen e faturimit të organizatës suaj.

Kreditet e dhëna dhe përdorimi i API-së japin informacione të ndryshme: kreditet e dhëna tregojnë kreditet e lidhura me organizatën tuaj, ndërsa përdorimi tregon aktivitetin e saj në API.

Shqyrtoni përdorimin dhe kostot e nivelit të shkallëzimit

Nëse organizata juaj e ka aktivizuar nivelin e shkallëzimit dhe ju keni qasjen e nevojshme, hapni faqen e përdorimit të nivelit të shkallëzimit për të parë detajet e përdorimit.

Kostot e paketave të nivelit të shkallëzimit i atribuohen organizatës, jo projekteve të veçanta.

Përdorimi është më i madh se zero, por shpenzimet e projektit janë zero

Kontrolloni nëse përdorimi i modelit mbulohet nga kuota juaj e nivelit të shkallëzimit. Nëse i gjithë përdorimi për atë model është brenda kuotës TPM të nivelit të shkallëzimit, projekti mund të tregojë përdorim pa shpenzime shtesë për modelin.

Kostoja e abonimit të nivelit të shkallëzimit mbetet në nivel organizate. Shqyrtoni shpenzimet e të gjithë organizatës në vend që të mbështeteni te shpenzimet e një projekti të vetëm.

Shqyrtoni disa organizata

Paneli i përdorimit nuk i bashkon të dhënat e kostove ose përdorimit nga organizata të ndryshme. Çdo organizatë, përfshirë një nënorganizatë, trajtohet veçmas.

Për të parë një nënorganizatë, zgjidheni te përzgjedhësi i organizatës.

Nëse ju nevojitet raportim i përbashkët, merrni parasysh përdorimin e projekteve brenda një organizate në vend të nënorganizatave të veçanta, ose përdorni API-në e përdorimit për analizë të personalizuar.

Kontrolloni përdorimin e tokenëve në një përgjigje të API-së

Emrat e fushave të përdorimit të tokenëve varen nga pika fundore.

Numri i tokenëvePërfundimet e bisedësPërgjigjet
Tokenët hyrësusage.prompt_tokensusage.input_tokens
Tokenët dalësusage.completion_tokensusage.output_tokens
Tokenët gjithsejusage.total_tokensusage.total_tokens

Përgjigjet e përfundimeve të bisedës mund të përfshijnë informacion për përdorimin e tokenëve. Shembujt përfshijnë:

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

Në varësi të pikës fundore dhe modelit, detajet e përdorimit mund të përfshijnë edhe numrin e tokenëve të hyrjes së ruajtur në memorien e përkohshme dhe të tokenëve të arsyetimit. Këto ndihmojnë për të shpjeguar pse gjatësia e dukshme e një përgjigjeje nuk pasqyron të gjithë tokenët e përdorur.

Për një shpjegim të kategorive të ndryshme të tokenëve, shihni: Kuptimi dhe numërimi i tokenëve.

Në një përgjigje transkriptimi që raporton përdorimin e tokenëve, tokenët hyrës të audios dhe tekstit janë tashmë të përfshirë në input_tokens. Mos i shtoni sërish këta përbërës në totalin e hyrjes. Krahasoni veçmas output_tokens.

Merrni të dhënat e përdorimit nga përfundimet e bisedës të transmetuara në rrjedhë

Për një kërkesë për përfundime bisede me transmetim në rrjedhë, përfshini:

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

Kur include_usage është aktivizuar, një fragment shtesë përpara data: [DONE] përmban të dhënat e përdorimit për të gjithë kërkesën. Vargu choices i këtij fragmenti është bosh. Në fragmentet e tjera, fusha usage ka vlerën null.

Nëse transmetimi ndërpritet, mund të mos e merrni atë fragment përfundimtar me të dhënat e përdorimit. Mungesa e fragmentit përfundimtar nuk vërteton se kërkesa nuk ka përdorur asnjë token.

Ky konfigurim vlen vetëm për përfundimet e bisedës. Për hollësi, shihni: Referenca e API-t të përfundimeve të bisedës.

A ishte i dobishëm ky artikull?