Ta stran je bila strojno prevedena. Oglejte si izvirni članek v angleščini.

Pregled porabe in stroškov API-ja

Preglejte dejavnost API-ja v Analitiki, preverite število žetonov v odgovorih API-ja ter spoznajte projektne filtre, izvoze in stroške lestvice zmogljivosti.

Posodobljeno: 6 days ago

Pregled

Uporabo API-ja lahko pregledate na dva načina:

  • V razdelku Analitika > Uporaba preglejte dejavnost API-ja v trenutnih in preteklih obdobjih poročanja.

  • Za preverjanje posamezne zahteve preberite podatke o uporabi v odgovoru API-ja.

Playground uporablja iste klice API-ja kot vaše aplikacije. Njegovi žetoni se vštevajo v uporabo API-ja vašega računa, zanje pa veljajo ista pravila uporabe in cene.

Dostop do nadzorne plošče

Za dostop do nadzorne plošče porabe morate biti lastnik organizacije ali imeti dovoljenje Nadzorna plošča porabe.

Pregled uporabe na nadzorni plošči

Na Platformi API odprite Analitiko in izberite Uporaba, da pregledate trenutni projekt. Za poročanje na ravni celotne organizacije izberite Analitika organizacije. Izberite obdobje poročanja, ki ga želite pregledati, in ga znova preverite po preklopu med analitiko projekta in organizacije.

Podatki na nadzorni plošči so prikazani v UTC. Upoštevajte ta časovni pas, ko primerjate dejavnost na nadzorni plošči z dnevniki aplikacije.

Nedavna uporaba se lahko na nadzorni plošči prikaže z zamikom. Če nedavna dejavnost manjka, preverite znova pozneje.

Filtriranje uporabe

V projektnem razdelku Analitika je uporaba omejena na izbrani projekt. V razdelku Analitika organizacije z možnostjo Projekt izberite projekte, ki jih želite pregledati. Možnost Vsi projekti vključuje vse projekte v organizaciji ob upoštevanju drugih izbranih filtrov.

Z možnostjo Filtri omejite uporabo glede na možnosti Viri API-ja, Ključi API, Modeli, Uporabniki ali Raven obdelave. Možnost Viri API-ja omogoča izbiro med Vsi viri API-ja, API za agente ali Neposredni API.

Odstranite posamezne izbire ali izberite Počisti filtre, da ponastavite podokno Filtri. Čiščenje filtrov ne preklopi med analitiko projekta in organizacije.

Z možnostjo Filter na grafikonu Uporaba filtrirajte po možnosti Paketna obdelava. Izberite Ponastavi filtre grafikona, da ponastavite filtre tega grafikona.

Če zmožnost ne podpira izbranih filtrov, njene vrednosti morda ne bodo na voljo. Nerazpoložljive vrednosti ne pomenijo, da uporabe ni bilo.

Če filter prikaže napako glede dovoljenj, morda nimate dostopa do njegovih možnosti. To ne pomeni, da uporaba ni bila zabeležena.

Pregled uporabe posameznega uporabnika

  1. Odprite Uporabo v pogledu Analitika za projekt ali organizacijo, ki jo želite pregledati. V tabeli Zmožnosti API-ja izberite Prikaži pri možnosti Odgovori in dopolnitve klepeta.

  2. V razdelku Filtri izberite Uporabniki in izberite uporabnika. Rezultati se takoj posodobijo.

  3. Preglejte grafikon in tabelo za tega uporabnika.

Za pregled uporabnikove uporabe vseh zmožnosti uporabite filter Uporabniki v pregledu Uporaba. Za primerjavo uporabnikov počistite ta filter in izberite zavihek tabele Uporabniki.

Prikaz žetonov na dan, uro ali minuto

Kjer so v razdelku Uporaba na voljo nastavitve intervala, izberite 1d ali 1h za prikaz žetonov po dnevih ali urah oziroma 1m za pregled žetonov na minuto (TPM). Izberite Samodejno, da nadzorna plošča sama izbere časovni interval za vaše obdobje poročanja. Ti intervali veljajo za podatke o uporabi, ne za obračunske podatke.

Če je možnost 1m onemogočena, izberite krajše obdobje poročanja ali uporabite Izberi za povečavo in povlecite po grafikonu, da zožite obseg. Nato izberite 1m. Pritisnite Esc, da prekličete izbiro za povečavo. V orodni vrstici razdelka Analitika izberite trenutni datumski obseg, da izberete drugo obdobje poročanja.

Pregled grafikonov in tabel uporabe

Z možnostjo Metrike izberite enega ali več podatkovnih nizov za skupni prikaz, vključno z možnostmi Vhodni žetoni, Nepredpomnjeni vhodni žetoni, Predpomnjeni vhodni žetoni, Vhodni žetoni za zapis v predpomnilnik, Vhodni zvočni žetoni, Izhodni žetoni in Izhodni zvočni žetoni. Razpoložljive metrike so odvisne od zmožnosti. Posamezne podatkovne nize prepoznate s pomočjo legende.

Z možnostjo Združi po razvrstite uporabo po kategorijah, kot so Projekt, Uporabnik ali Model, kjer so na voljo. Filtri določajo, katera uporaba je vključena, združevanje pa določa način njenega prikaza. Preklapljajte med črtnimi in stolpčnimi grafikoni za pregled trendov ali primerjavo kategorij.

Na zavihkih tabele Uporaba si oglejte razpoložljive razčlenitve. Tabele za vsako vrstico prikazujejo ustrezne mere, kot so zahteve, vhodni in izhodni žetoni ali enote, značilne za posamezno zmožnost.

V razdelku Zmožnosti API-ja pri posamezni zmožnosti izberite Prikaži, da odprete podrobne grafikone in razčlenitve. Razdelek Odgovori in dopolnitve klepeta vključuje ločena grafikona Žetoni in Zahteve ter metriko Zahteve za model. Zavihki z razčlenitvami uporabljajo iste dimenzije kot pregled, vendar brez zavihka Zmožnosti API-ja. Za vrnitev na pregled uporabite povezavo Uporaba v navigacijski poti.

Ko izberete možnost Združi po, lahko grafikon dodatne kategorije združi pod Drugo. Če se v legendi grafikona pojavi Drugo, izberite to oznako, da si ogledate vključene kategorije in njihove vrednosti uporabe.

Izberite Primerjaj nadzorne plošče, da si ogledate Uporabo ob drugi nadzorni plošči za isto obdobje poročanja. Prikaza izberite z možnostma Leva nadzorna plošča in Desna nadzorna plošča. Če izbrani časovni interval za par nadzornih plošč ni na voljo, se prikaz preklopi na Samodejno. Izberite Zapri primerjavo, da se vrnete na nadzorno ploščo.

Preverjanje uporabe, ki je ne prepoznate

Če razdelek Uporaba prikazuje dejavnost, ki je ne morete povezati z zahtevami v dnevnikih aplikacije, preverite naslednje:

  1. Preverite organizacijo, obseg projektov in obdobje poročanja. Pri primerjavi časovnih žigov na nadzorni plošči z dnevniki aplikacije uporabljajte UTC.

  2. Uporabite projektni pogled za zadevni projekt ali ga izberite pod Projekt v razdelku Analitika organizacije. Nato z možnostjo Filtri omejite uporabo glede na ključ API in model ter izberite krajše obdobje poročanja.

  3. Primerjajte dejavnost z dnevniki za isto obdobje, projekt in ključ API. Preverite, ali dnevniki zajemajo vse aplikacije ali integracije, ki uporabljajo ta ključ.

  4. Če si več aplikacij ali integracij deli isti projekt ali ključ API, samo na podlagi skupne vrednosti morda ne boste mogli ugotoviti, katera je poslala zahtevo. Primerjajte nadzorno ploščo z zapisi posameznih aplikacij za isto obdobje v UTC.

  5. Če uporabe še vedno ne morete pojasniti, se obrnite na podporo OpenAI in navedite zadevno obdobje v UTC, ID-je organizacije in projekta, identifikator ključa API ter ustrezne posnetke zaslona ali dnevnike. Če so na voljo, vključite ID-je zahtev. Ne vključujte skrivnih ključev API.

Izvoz podatkov o uporabi

Za izvoz uporabe izberite ikono Izvozi CSV v orodni vrstici razdelka Analitika, nato izberite Podatki o dejavnosti.

  1. Izberite Zmožnost API-ja in eno ali več dimenzij v možnosti Združi po.

  2. Preverite možnosti Vir API-ja, Projekti, Uporabniki, Ključi API in Modeli. Možnosti Projekti in Vir API-ja sta vnaprej izbrani glede na nastavitve v razdelku Analitika; druge filtre za izvoz izberite v pogovornem oknu.

  3. Izberite Oblika datoteke, Začetni čas, Končni čas in Časovni interval, nato izberite Prenesi. Datumi vključujejo cele dneve po UTC.

Podatki o dejavnosti in stroških so na voljo za ogled in izvoz za obdobje od 00:00 UTC na dan pred enim koledarskim letom do danes. Za starejše podatke se obrnite na podporo OpenAI. Dnevni podatki se izvozijo v datoteke, ki zajemajo 31-dnevna obdobja.

Za usklajevanje mesečnih računov in izvoz posameznih postavk glejte: Izvoz podrobnosti o mesečni uporabi.

Če izvoz dejavnosti vključuje vrstice z negativnimi vrednostmi, primerjajte vrstice z isto enoto, združevanjem in datumi. Za zaračunane zneske uporabite Podatke o stroških. Vrstica dejavnosti z negativno vrednostjo sama po sebi ne pomeni, da je bil za vaš račun izdan dobropis.

Pregled stroškov

Odprite Analitiko in izberite Stroški, da pregledate stroške trenutnega projekta. Za stroške celotne organizacije izberite Analitika organizacije in nato Stroški.

Pred primerjavo stroškov z uporabo preverite trenutni datumski obseg in filtre. Razdelka Uporaba in Stroški ponujata različne filtre; filter, ki je na voljo na eni nadzorni plošči, morda ne velja za drugo.

Z možnostmi Viri API-ja, Ključi API, Modeli in Postavke omejite prikaz stroškov. V analitiki organizacije z možnostjo Projekt vključite projekte, ki jih želite pregledati. Za razpoložljive razčlenitve uporabite zavihke tabele Postavke, Ključi API, Uporabniki, Projekti in Modeli.

Če vrednost omejitve porabe ni na voljo, to ne pomeni, da je vaša omejitev nič ali da je bila uveljavljena nova omejitev. Dovoljenja za dostop, nenastavljena omejitev ali neuspešna zahteva lahko preprečijo prikaz vrednosti na nadzorni plošči.

Pregled stanja storitve

Če ima vaša organizacija dostop do razdelka Stanje storitve, odprite to nadzorno ploščo v razdelku Analitika, da pregledate delovanje API-ja. Za pogoje dostopa in opredelitve metrik glejte: Odpravljanje napak in zakasnitev API-ja.

Ogled dodeljenih točk

Podrobnosti o dodeljenih točkah so na voljo na strani za obračunavanje vaše organizacije.

Dodeljene točke in uporaba API-ja odgovarjajo na različni vprašanji: dodeljene točke prikazujejo točke, povezane z vašo organizacijo, uporaba pa njeno dejavnost API-ja.

Pregled porabe in stroškov lestvice zmogljivosti

Če ima vaša organizacija omogočeno lestvico zmogljivosti in imate potreben dostop, za podroben pregled odprite stran s porabo lestvice zmogljivosti.

Stroški paketov lestvice zmogljivosti se pripišejo organizaciji, ne posameznim projektom.

Uporaba je večja od nič, stroški projekta pa so nič

Preverite, ali je uporaba modela zajeta v vaši dodeljeni količini v okviru lestvice zmogljivosti. Če je vsa uporaba tega modela znotraj dodeljene količine TPM v okviru lestvice zmogljivosti, lahko projekt prikazuje uporabo brez dodatnih stroškov za model.

Stroški naročnine za lestvico zmogljivosti ostanejo na ravni organizacije. Preglejte stroške celotne organizacije, namesto da se zanašate na stroške posameznega projekta.

Pregled več organizacij

Nadzorna plošča Uporaba ne združuje podatkov o stroških ali uporabi iz več organizacij. Vsaka organizacija, vključno s podorganizacijami, se obravnava ločeno.

Za prikaz podorganizacije jo izberite v izbirniku organizacije.

Če potrebujete združeno poročanje, razmislite o uporabi projektov znotraj ene organizacije namesto ločenih podorganizacij ali pa za analizo po meri uporabite API za uporabo.

Preverjanje porabe žetonov v odgovoru API-ja

Imena polj za porabo žetonov so odvisna od končne točke.

Število žetonovDopolnitve klepetaOdgovori
Vhodni žetoniusage.prompt_tokensusage.input_tokens
Izhodni žetoniusage.completion_tokensusage.output_tokens
Skupno število žetonovusage.total_tokensusage.total_tokens

Odgovori API-ja za dopolnitve klepeta lahko vključujejo podatke o porabi žetonov. Primeri vključujejo:

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

Podrobnosti o uporabi lahko glede na končno točko in model vključujejo tudi število predpomnjenih vhodnih žetonov in žetonov za sklepanje. Ti podatki pomagajo pojasniti, zakaj vidna dolžina odgovora ne odraža celotne porabe žetonov.

Za razlago različnih kategorij žetonov glejte: Razumevanje in štetje žetonov.

V odgovoru na zahtevo za prepis, ki navaja porabo žetonov, so zvočni in besedilni vhodni žetoni že vključeni v input_tokens. Teh žetonov ne prištevajte znova k skupnemu številu vhodnih žetonov. Vrednost output_tokens primerjajte ločeno.

Pridobivanje podatkov o porabi pri pretočnih dopolnitvah klepeta

V zahtevo za pretočne dopolnitve klepeta vključite:

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

Če je možnost include_usage omogočena, dodatni del pred data: [DONE] vsebuje podatke o porabi za celotno zahtevo. Njegova tabela choices je prazna. V drugih delih ima polje usage vrednost null.

Če se pretok prekine, tega zadnjega dela s podatki o porabi morda ne boste prejeli. Če zadnji del manjka, to še ne pomeni, da zahteva ni porabila nobenega žetona.

Ta nastavitev velja samo za dopolnitve klepeta. Za podrobnosti glejte: Referenčna dokumentacija za API za dopolnitve klepeta.

Ali vam je bil ta članek v pomoč?