Pregled
Korištenje API-ja možete pregledati na dva načina:
Otvorite Analitika > Korištenje da biste pregledali API aktivnost u tekućem i prethodnim izvještajnim periodima.
Pročitajte informacije o korištenju u API odgovoru da biste provjerili pojedinačni zahtjev.
Playground koristi iste API pozive kao vaše aplikacije. Njegovi tokeni ulaze u korištenje API-ja na vašem računu i na njih se primjenjuju ista pravila korištenja i cijene.
Pristup kontrolnoj tabli
Za pristup Kontrolnoj tabli korištenja morate biti vlasnik organizacije ili imati dozvolu Kontrolna tabla korištenja.
Pregledajte korištenje na nadzornoj ploči
Na platformi API Platform otvorite Analitika i odaberite Korištenje da biste pregledali trenutni projekt. Za izvještaje na nivou cijele organizacije odaberite Analitika organizacije. Odaberite izvještajni period koji želite pregledati i ponovo ga provjerite nakon prelaska između analitike projekta i analitike organizacije.
Podaci na nadzornoj ploči prikazuju se po UTC-u. Imajte tu vremensku zonu na umu kada upoređujete aktivnost na nadzornoj ploči sa zapisnicima aplikacije.
Može proći neko vrijeme prije nego što se nedavno korištenje pojavi na nadzornoj ploči. Ako nedavna aktivnost nedostaje, provjerite ponovo kasnije.
Filtrirajte podatke o korištenju
U odjeljku Analitika projekta podaci o korištenju ograničeni su na odabrani projekt. U odjeljku Analitika organizacije pomoću opcije Projekt odaberite projekte koje želite pregledati. Opcija Svi projekti uključuje svaki projekt u organizaciji, uz primjenu svih ostalih odabranih filtera.
Pomoću opcije Filteri suzite podatke o korištenju prema opcijama Izvori API-ja, API ključevi, Modeli, Korisnici ili Nivo obrade. Opcija Izvori API-ja omogućava odabir između Svi izvori API-ja, API za agente i Direktni API.
Uklonite pojedinačne odabire ili odaberite Obriši filtere da biste vratili panel Filteri na početne postavke. Brisanjem filtera ne prelazite s analitike projekta na analitiku organizacije niti obrnuto.
Pomoću opcije Filter na grafikonu Korištenje filtrirajte prema opciji Skupna obrada. Odaberite Vrati filtere grafikona na početne postavke da biste poništili filtere tog grafikona.
Ako funkcionalnost ne podržava odabrane filtere, njene vrijednosti možda neće biti dostupne. Nedostupne vrijednosti ne znače da nije bilo korištenja.
Ako filter prikazuje grešku vezanu za dozvole, možda nemate pristup njegovim opcijama. To ne znači da korištenje nije zabilježeno.
Pregledajte korištenje pojedinačnog korisnika
Otvorite Korištenje u prikazu Analitika za projekt ili organizaciju koju želite pregledati. U tabeli Funkcionalnosti API-ja odaberite Prikaži za Odgovori i dovršavanje razgovora.
U odjeljku Filteri odaberite Korisnici, a zatim odaberite korisnika. Rezultati se odmah ažuriraju.
Pregledajte grafikon i tabelu za tog korisnika.
Da biste pregledali korištenje korisnika u svim funkcionalnostima, primijenite filter Korisnici u pregledu Korištenje. Da biste uporedili korisnike, uklonite taj filter i odaberite karticu tabele Korisnici.
Prikažite tokene po danu, satu ili minuti
Ako su u odjeljku Korištenje dostupne kontrole intervala, odaberite 1d ili 1h za prikaz tokena po danu ili satu, odnosno 1m za pregled tokena po minuti (TPM). Odaberite Automatski da bi nadzorna ploča odabrala vremenski interval za vaš izvještajni period. Ovi intervali primjenjuju se na podatke o korištenju, a ne na podatke o naplati.
Ako je opcija 1m onemogućena, odaberite kraći izvještajni period ili upotrijebite Odaberi za uvećanje i povucite preko grafikona da biste suzili raspon. Zatim odaberite 1m. Pritisnite Esc da biste otkazali odabir za uvećanje. Odaberite trenutni raspon datuma na alatnoj traci odjeljka Analitika da biste izabrali drugi izvještajni period.
Pregledajte grafikone i tabele korištenja
U opciji Metrike odaberite jedan ili više nizova podataka za zajednički prikaz, uključujući Ulazni tokeni, Nekeširani ulazni tokeni, Keširani ulazni tokeni, Ulazni tokeni za upis u keš, Ulazni audiotokeni, Izlazni tokeni i Izlazni audiotokeni. Dostupne metrike zavise od funkcionalnosti. Pomoću legende prepoznajte svaki niz podataka.
Pomoću opcije Grupiraj prema organizirajte korištenje po kategorijama kao što su Projekt, Korisnik ili Model, gdje su dostupne. Filteri određuju koji su podaci o korištenju uključeni, a grupiranje određuje kako se prikazuju. Prebacujte se između linijskih i stubičastih grafikona da biste pregledali trendove ili uporedili kategorije.
Na karticama tabele Korištenje pregledajte dostupne raščlanjene podatke. Tabele prikazuju relevantne mjere za svaki red, kao što su zahtjevi, ulazni i izlazni tokeni ili jedinice specifične za funkcionalnost.
U odjeljku Funkcionalnosti API-ja odaberite Prikaži za određenu funkcionalnost da biste otvorili njene detaljne grafikone i raščlanjene podatke. Odjeljak Odgovori i dovršavanje razgovora sadrži zasebne grafikone Tokeni i Zahtjevi te metriku Zahtjevi modelu. Njegove kartice s raščlanjenim podacima koriste iste dimenzije kao pregled, ali bez kartice Funkcionalnosti API-ja. Za povratak na pregled odaberite Korištenje u navigacijskoj putanji.
Nakon odabira opcije Grupiraj prema, grafikon može objediniti dodatne kategorije pod Ostalo. Ako se u legendi grafikona pojavi Ostalo, odaberite tu oznaku da biste vidjeli uključene kategorije i njihove vrijednosti korištenja.
Odaberite Uporedi nadzorne ploče da biste prikazali Korištenje uz drugu nadzornu ploču za isti izvještajni period. Prikaze odaberite pomoću opcija Lijeva nadzorna ploča i Desna nadzorna ploča. Ako odabrani vremenski interval nije dostupan za taj par nadzornih ploča, prikaz se prebacuje na Automatski. Odaberite Izađi iz poređenja za povratak na nadzornu ploču.
Istražite korištenje koje ne prepoznajete
Ako odjeljak Korištenje prikazuje aktivnost koju ne možete povezati sa zahtjevima u zapisnicima aplikacije, izvršite sljedeće provjere:
Provjerite organizaciju, obuhvaćene projekte i izvještajni period. Koristite UTC kada upoređujete vremenske oznake na nadzornoj ploči sa zapisnicima aplikacije.
Otvorite prikaz dotičnog projekta ili ga odaberite pod Projekt u odjeljku Analitika organizacije. Zatim pomoću opcije Filteri suzite podatke o korištenju prema API ključu i modelu te odaberite kraći izvještajni period.
Uporedite aktivnost sa zapisnicima za isti period, projekt i API ključ. Provjerite obuhvataju li vaši zapisnici sve aplikacije ili integracije koje koriste taj ključ.
Ako više aplikacija ili integracija dijeli isti projekt ili API ključ, sam ukupan iznos možda neće pokazati koja je poslala zahtjev. Uporedite nadzornu ploču sa zapisima iz svake aplikacije za isti period po UTC-u.
Ako i dalje ne možete objasniti korištenje, kontaktirajte podršku kompanije OpenAI i navedite dotični period po UTC-u, ID-ove organizacije i projekta, identifikator API ključa te relevantne snimke ekrana ili zapisnike. Uključite ID-ove zahtjeva ako su dostupni. Nemojte uključivati tajne API ključeve.
Izvezite podatke o korištenju
Za izvoz podataka o korištenju odaberite ikonu Izvezi CSV na alatnoj traci odjeljka Analitika, a zatim odaberite Podaci o aktivnosti.
Odaberite Funkcionalnost API-ja i jednu ili više dimenzija pod Grupiraj prema.
Provjerite opcije Izvor API-ja, Projekti, Korisnici, API ključevi i Modeli. Opcije Projekti i Izvor API-ja unaprijed su odabrane prema odabiru u odjeljku Analitika; ostale filtere za izvoz odaberite u dijaloškom okviru.
Odaberite Format datoteke, Vrijeme početka, Vrijeme završetka i Vremenski interval, a zatim odaberite Preuzmi. Datumi obuhvataju cijele dane po UTC-u.
Podaci o aktivnosti i troškovima dostupni su za pregled i izvoz od 00:00 UTC na datum prije jedne kalendarske godine do danas. Za starije podatke kontaktirajte podršku kompanije OpenAI. Dnevni podaci izvoze se u datotekama koje obuhvataju periode od po 31 dan.
Za usklađivanje mjesečnih faktura i izvoz pojedinačnih stavki pogledajte: Izvoz detalja o mjesečnom korištenju.
Ako izvoz podataka o aktivnosti sadrži redove s negativnim vrijednostima, uporedite redove s istom jedinicom, grupiranjem i datumima. Za fakturirane iznose koristite Podaci o troškovima. Sam red aktivnosti s negativnom vrijednošću ne potvrđuje da vam je odobreno umanjenje fakture.
Pregledajte troškove
Otvorite Analitika i odaberite Troškovi da biste pregledali troškove trenutnog projekta. Za troškove na nivou cijele organizacije odaberite Analitika organizacije, a zatim Troškovi.
Provjerite trenutni raspon datuma i filtere prije nego što uporedite troškove s korištenjem. Odjeljci Korištenje i Troškovi nude različite filtere; filter dostupan na jednoj nadzornoj ploči možda nije primjenjiv na drugu.
Pomoću opcija Izvori API-ja, API ključevi, Modeli i Stavke suzite prikaz troškova. U analitici organizacije pomoću opcije Projekt uključite projekte koje želite pregledati. Na karticama tabele Stavke, API ključevi, Korisnici, Projekti i Modeli pregledajte dostupne raščlanjene podatke.
Nedostupna vrijednost ograničenja potrošnje ne znači da je vaše ograničenje nula ili da je primijenjeno novo ograničenje. Dozvole za pristup, nepostavljeno ograničenje ili neuspjeli zahtjev mogu spriječiti prikaz vrijednosti na nadzornoj ploči.
Pregledajte stanje usluge
Ako vaša organizacija ima pristup odjeljku Stanje usluge, otvorite tu nadzornu ploču u odjeljku Analitika da biste pregledali performanse API-ja. Za uslove pristupa i definicije metrika pogledajte: Rješavanje problema s API greškama i kašnjenjem.
Pregledajte dodijeljene kredite
Detalji o dodijeljenim kreditima dostupni su na stranici za naplatu vaše organizacije.
Dodijeljeni krediti i korištenje API-ja pružaju različite informacije: dodijeljeni krediti prikazuju kredite povezane s vašom organizacijom, dok korištenje prikazuje njenu API aktivnost.
Pregled korištenja i troškova Nivoa skale
Ako je u vašoj organizaciji omogućen Nivo skale i imate potreban pristup, otvorite stranicu korištenja Nivoa skale za detaljne podatke o korištenju.
Troškovi paketa Nivoa skale pripisuju se organizaciji, a ne pojedinačnim projektima.
Korištenje je veće od nule, ali troškovi projekta su nula
Provjerite pokriva li vaša kvota za Nivo skale korištenje modela. Ako je cjelokupno korištenje tog modela unutar TPM kvote za Nivo skale, projekt može prikazivati korištenje bez dodatnih troškova modela.
Trošak pretplate na Nivo skale ostaje na nivou organizacije. Pregledajte troškove cijele organizacije umjesto da se oslanjate na troškove pojedinačnog projekta.
Pregledajte više organizacija
Nadzorna ploča korištenja ne objedinjuje podatke o troškovima ili korištenju iz različitih organizacija. Svaka organizacija, uključujući podorganizacije, tretira se zasebno.
Da biste prikazali podorganizaciju, odaberite je u biraču organizacija.
Ako su vam potrebni objedinjeni izvještaji, razmotrite korištenje projekata unutar jedne organizacije umjesto zasebnih podorganizacija ili upotrijebite API za korištenje za prilagođenu analizu.
Provjerite korištenje tokena u API odgovoru
Nazivi polja za korištenje tokena zavise od krajnje tačke.
| Broj tokena | Dovršavanje razgovora | Odgovori |
|---|---|---|
| Ulazni tokeni | usage.prompt_tokens | usage.input_tokens |
| Izlazni tokeni | usage.completion_tokens | usage.output_tokens |
| Ukupno tokena | usage.total_tokens | usage.total_tokens |
Odgovori za dovršavanje razgovora mogu sadržavati informacije o korištenju tokena. Primjeri uključuju:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Zavisno od krajnje tačke i modela, detalji o korištenju mogu uključivati i broj keširanih ulaznih tokena i tokena za rezonovanje. Ovi podaci pomažu objasniti zašto vidljiva dužina odgovora ne odražava ukupnu potrošnju tokena.
Za objašnjenje različitih kategorija tokena pogledajte: Razumijevanje i brojanje tokena.
U odgovoru na zahtjev za transkripciju koji sadrži podatke o potrošnji tokena, ulazni audio i tekstualni tokeni već su uključeni u input_tokens. Nemojte ih ponovo dodavati ukupnom broju ulaznih tokena. Zasebno uporedite output_tokens.
Dohvatite podatke o potrošnji pri strimovanju dovršavanja razgovora
U zahtjev za dovršavanje razgovora sa strimovanjem uključite:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Kada je include_usage uključen, dodatni dio podataka prije data: [DONE] sadrži podatke o potrošnji za cijeli zahtjev. Njegov niz choices je prazan. U ostalim dijelovima podataka polje usage ima vrijednost null.
Ako se strimovanje prekine, možda nećete primiti taj završni dio s podacima o potrošnji. Izostanak završnog dijela ne dokazuje da zahtjev nije potrošio nijedan token.
Ova konfiguracija važi samo za dovršavanje razgovora. Za detalje pogledajte: Referentna dokumentacija za API za dovršavanje razgovora.
