Pregled
Korištenje API-ja možete pregledati na dva načina:
Otvorite Analitika > Korištenje za pregled aktivnosti API-ja u trenutačnim i prošlim izvještajnim razdobljima.
Pročitajte podatke o korištenju u odgovoru API-ja da biste provjerili pojedinačni zahtjev.
Playground koristi iste API pozive kao i vaše aplikacije. Njegovi tokeni ubrajaju se u korištenje API-ja na vašem računu te za njih vrijede ista pravila korištenja i cijene.
Pristup nadzornoj ploči
Za pristup Nadzornoj ploči upotrebe morate biti vlasnik organizacije ili imati dopuštenje Nadzorna ploča upotrebe.
Pregledajte korištenje na nadzornoj ploči
Na Platformi API otvorite Analitika i odaberite Korištenje za pregled trenutačnog projekta. Za izvještaje na razini cijele organizacije odaberite Analitika organizacije. Odaberite izvještajno razdoblje koje želite pregledati i ponovno ga provjerite nakon prebacivanja između analitike projekta i analitike organizacije.
Podaci na nadzornoj ploči prikazuju se prema UTC-u. Imajte tu vremensku zonu na umu pri usporedbi aktivnosti na nadzornoj ploči sa zapisnicima svoje aplikacije.
Može proći neko vrijeme prije nego što se nedavno korištenje pojavi na nadzornoj ploči. Ako nedostaje nedavna aktivnost, provjerite ponovno kasnije.
Filtrirajte podatke o korištenju
U prikazu Analitika za projekt 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 obuhvaća sve projekte u organizaciji, uz primjenu ostalih odabranih filtara.
Pomoću opcije Filtri suzite prikaz korištenja prema opcijama Izvori API-ja, API ključevi, Modeli, Korisnici ili Razina obrade. Opcija Izvori API-ja omogućuje odabir između opcija Svi izvori API-ja, API za agente i Izravni API.
Uklonite pojedinačne odabire ili odaberite Očisti filtre da biste ploču Filtri vratili na početno stanje. Brisanje filtara ne prebacuje prikaz između analitike projekta i analitike organizacije.
Pomoću opcije Filtar na grafikonu Korištenje filtrirajte prema opciji Skupna obrada. Odaberite Poništi filtre grafikona da biste poništili filtre tog grafikona.
Ako funkcionalnost ne podržava odabrane filtre, njezine vrijednosti možda neće biti dostupne. Nedostupne vrijednosti ne znače da nije bilo korištenja.
Ako filtar prikazuje pogrešku povezanu s dozvolama, možda nemate pristup njegovim opcijama. To ne znači da korištenje nije zabilježeno.
Pregledajte korištenje pojedinog korisnika
Otvorite Korištenje u prikazu Analitika za projekt ili organizaciju koju želite pregledati. U tablici Funkcionalnosti API-ja odaberite Prikaži uz Odgovori i dovršavanje razgovora.
U odjeljku Filtri odaberite Korisnici, a zatim korisnika. Rezultati se odmah ažuriraju.
Pregledajte grafikon i tablicu za tog korisnika.
Za pregled korištenja različitih funkcionalnosti za jednog korisnika primijenite filtar Korisnici na pregledu Korištenje. Za usporedbu korisnika uklonite taj filtar i odaberite karticu tablice Korisnici.
Prikažite tokene po danu, satu ili minuti
Ako su u odjeljku Korištenje dostupne kontrole intervala, odaberite 1 d ili 1 h za prikaz tokena po danu ili satu, odnosno 1 min za pregled tokena u minuti (TPM). Odaberite Automatski da bi nadzorna ploča odabrala vremenski interval za vaše izvještajno razdoblje. Ti se intervali odnose na podatke o korištenju, a ne na podatke o naplati.
Ako je opcija 1 min onemogućena, odaberite kraće izvještajno razdoblje ili upotrijebite Odaberi za zumiranje i povucite preko grafikona da biste suzili raspon. Zatim odaberite 1 min. Pritisnite Esc da biste poništili odabir za zumiranje. Odaberite trenutačni raspon datuma na alatnoj traci odjeljka Analitika da biste odabrali drugo izvještajno razdoblje.
Pregledajte grafikone i tablice korištenja
U odjeljku Metrike odaberite jedan ili više nizova podataka za zajednički prikaz, uključujući Ulazni tokeni, Ulazni tokeni izvan predmemorije, Ulazni tokeni u predmemoriji, Ulazni tokeni za upis u predmemoriju, Ulazni audiotokeni, Izlazni tokeni i Izlazni audiotokeni. Dostupne metrike ovise o funkcionalnosti. Pomoću legende prepoznajte pojedine nizove podataka.
Pomoću opcije Grupiraj po organizirajte korištenje prema kategorijama kao što su Projekt, Korisnik ili Model, ako su dostupne. Filtri određuju koji su podaci o korištenju uključeni, a grupiranje određuje kako se prikazuju. Prebacujte se između linijskih i stupčastih grafikona kako biste pratili trendove ili usporedili kategorije.
Na karticama tablice Korištenje pregledajte dostupne raščlambe. Tablice za svaki redak prikazuju relevantne mjere, poput zahtjeva, ulaznih i izlaznih tokena ili jedinica specifičnih za funkcionalnost.
U odjeljku Funkcionalnosti API-ja odaberite Prikaži uz funkcionalnost da biste otvorili njezine detaljne grafikone i raščlambe. Odjeljak Odgovori i dovršavanje razgovora uključuje zasebne grafikone Tokeni i Zahtjevi te metriku Zahtjevi modelu. Njegove kartice s raščlambama koriste iste dimenzije kao pregled, ali bez kartice Funkcionalnosti API-ja. Za povratak na pregled odaberite Korištenje u navigacijskoj putanji.
Nakon što odaberete opciju Grupiraj po, 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 Usporedi nadzorne ploče da biste prikazali Korištenje uz drugu nadzornu ploču za isto izvještajno razdoblje. Za odabir prikaza upotrijebite opcije 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 usporedbe 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 svoje aplikacije, provjerite sljedeće:
Provjerite organizaciju, obuhvat projekata i izvještajno razdoblje. Pri usporedbi vremenskih oznaka s nadzorne ploče sa zapisnicima svoje aplikacije koristite UTC.
Otvorite prikaz dotičnog projekta ili ga odaberite pod Projekt u odjeljku Analitika organizacije. Zatim pomoću opcije Filtri suzite prikaz korištenja prema API ključu i modelu te odaberite kraće izvještajno razdoblje.
Usporedite aktivnost sa zapisnicima za isto razdoblje, projekt i API ključ. Provjerite obuhvaćaju 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 ukupni iznos korištenja možda neće otkriti koja je od njih poslala zahtjev. Usporedite podatke s nadzorne ploče sa zapisima svake aplikacije za isto razdoblje prema UTC-u.
Ako i dalje ne možete objasniti korištenje, obratite se podršci za OpenAI i navedite dotično razdoblje prema UTC-u, ID-jeve organizacije i projekta, identifikator API ključa te relevantne snimke zaslona ili zapisnike. Priložite ID-jeve zahtjeva ako su dostupni. Nemojte slati 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 Podaci o aktivnosti.
Odaberite Funkcionalnost API-ja i jednu ili više dimenzija u opciji Grupiraj po.
Provjerite opcije Izvor API-ja, Projekti, Korisnici, API ključevi i Modeli. Odabiri za Projekti i Izvor API-ja unaprijed su preuzeti iz odjeljka Analitika; ostale filtre za izvoz odaberite u dijaloškom okviru.
Odaberite Format datoteke, Vrijeme početka, Vrijeme završetka i Vremenski interval, a zatim Preuzmi. Datumi obuhvaćaju cijele dane prema 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 obratite se podršci za OpenAI. Dnevni podaci izvoze se u datotekama koje obuhvaćaju razdoblja od 31 dana.
Za usklađivanje mjesečnih računa i izvoz pojedinačnih stavki pogledajte: Izvoz detalja o mjesečnom korištenju.
Ako izvezeni podaci o aktivnosti sadrže retke s negativnim vrijednostima, usporedite retke s istom jedinicom, grupiranjem i datumima. Za naplaćene iznose koristite Podaci o troškovima. Sam redak aktivnosti s negativnom vrijednošću ne potvrđuje da je na vašem računu odobreno umanjenje.
Pregledajte troškove
Otvorite Analitika i odaberite Troškovi za pregled troškova trenutačnog projekta. Za troškove na razini cijele organizacije odaberite Analitika organizacije, a zatim Troškovi.
Prije usporedbe troškova s korištenjem provjerite trenutačni raspon datuma i filtre. Prikazi Korištenje i Troškovi nude različite filtre; filtar dostupan na jednoj nadzornoj ploči možda se ne može primijeniti na drugoj.
Za sužavanje prikaza troškova upotrijebite opcije Izvori API-ja, API ključevi, Modeli i Stavke. U analitici organizacije pomoću opcije Projekt uključite projekte koje želite pregledati. Za dostupne raščlambe upotrijebite kartice tablice Stavke, API ključevi, Korisnici, Projekti i Modeli.
Ako vrijednost ograničenja potrošnje nije dostupna, to ne znači da vaše ograničenje iznosi nula ili da je primijenjeno novo ograničenje. Dozvole pristupa, nepostavljeno ograničenje ili neuspjeli zahtjev mogu spriječiti prikaz vrijednosti na nadzornoj ploči.
Pregledajte stanje usluge
Ako vaša organizacija ima pristup prikazu Stanje usluge, otvorite tu nadzornu ploču u odjeljku Analitika da biste pregledali performanse API-ja. Za uvjete pristupa i definicije metrika pogledajte: Otklanjanje pogrešaka i kašnjenja API-ja.
Prikažite 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 njezinu aktivnost API-ja.
Pregled upotrebe i troškova Razine skaliranja
Ako je Razina skaliranja omogućena za vašu organizaciju i imate potreban pristup, otvorite stranicu upotrebe Razine skaliranja za detaljan pregled upotrebe.
Troškovi paketa Razine skaliranja pripisuju se organizaciji, a ne pojedinačnim projektima.
Korištenje je veće od nule, ali troškovi projekta iznose nula
Provjerite je li korištenje modela pokriveno dodijeljenim kapacitetom u okviru Razine skaliranja. Ako je cjelokupno korištenje tog modela unutar dodijeljenog kapaciteta tokena u minuti (TPM) u okviru Razine skaliranja, projekt može prikazivati korištenje bez dodatnih troškova modela.
Trošak pretplate na Razinu skaliranja ostaje na razini organizacije. Pregledajte troškove na razini cijele organizacije umjesto da se oslanjate na troškove pojedinog 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, obrađuje se zasebno.
Za prikaz podorganizacije odaberite je u izborniku organizacija.
Ako trebate objedinjene izvještaje, razmislite o upotrebi projekata unutar jedne organizacije umjesto zasebnih podorganizacija ili upotrijebite API za korištenje za prilagođenu analizu.
Provjerite korištenje tokena u odgovoru API-ja
Nazivi polja za korištenje tokena ovise o krajnjoj točki.
| 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 API-ja za dovršavanje razgovora mogu sadržavati podatke o korištenju tokena. Primjeri uključuju:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Ovisno o krajnjoj točki i modelu, pojedinosti o upotrebi mogu uključivati i broj predmemoriranih ulaznih tokena te tokena za rasuđivanje. Ti podaci pomažu objasniti zašto vidljiva duljina odgovora ne odražava njegovu 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 tokeni za zvuk i tekst već su uključeni u input_tokens. Nemojte ponovno pribrajati te sastavnice ukupnom broju ulaznih tokena. Zasebno usporedite output_tokens.
Dohvatite podatke o potrošnji pri strujanju odgovora Chat Completions
Za zahtjev Chat Completions sa strujanjem odgovora uključite:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Kad je omogućen include_usage, dodatni blok prije data: [DONE] sadrži podatke o potrošnji za cijeli zahtjev. Njegovo polje choices prazno je. U ostalim blokovima usage ima vrijednost null.
Ako se strujanje prekine, možda nećete primiti taj završni blok s podacima o potrošnji. Izostanak završnog bloka ne dokazuje da zahtjev nije potrošio nijedan token.
Ova konfiguracija vrijedi samo za Chat Completions. Za pojedinosti pogledajte: Referentna dokumentacija API-ja za dovršavanje razgovora.
