Yfirlit
Þú getur skoðað API-notkun á tvo vegu:
Notaðu Greining > Notkun til að skoða API-virkni á núverandi og fyrri skýrslutímabilum.
Lestu notkunarupplýsingarnar í API-svari til að athuga einstaka beiðni.
Playground notar sömu API-köll og forritin þín. Tókar þess teljast með í API-notkun reikningsins þíns og lúta sömu notkunarreglum og verðlagningu.
Aðgangur að yfirlitinu
Þú verður að vera eigandi fyrirtækisins eða hafa heimildina Notkunaryfirlit til að fá aðgang að notkunaryfirlitinu.
Skoða notkun á mælaborðinu
Opnaðu Greining á API Platform og veldu Notkun til að skoða núverandi verkefni. Til að sjá skýrslur fyrir allt fyrirtækið skaltu velja Greining fyrirtækis. Veldu skýrslutímabilið sem þú vilt skoða og athugaðu það aftur eftir að þú skiptir á milli greiningar verkefnis og fyrirtækis.
Gögn á mælaborðinu eru birt samkvæmt UTC. Hafðu það tímabelti í huga þegar þú berð virkni á mælaborðinu saman við annála forritsins þíns.
Það getur tekið tíma þar til nýleg notkun birtist á mælaborðinu. Ef nýlega virkni vantar skaltu athuga aftur síðar.
Sía notkun
Í Greining fyrir verkefni er aðeins sýnd notkun valda verkefnisins. Í Greining fyrirtækis skaltu nota Verkefni til að velja þau verkefni sem þú vilt skoða. Öll verkefni nær yfir öll verkefni fyrirtækisins, með fyrirvara um aðrar síur sem þú hefur valið.
Notaðu Síur til að afmarka notkun eftir API-uppruni, API-lyklar, Líkön, Notendur eða Vinnslustig. Undir API-uppruni geturðu valið Allur API-uppruni, API fyrir fulltrúa eða Beint API.
Fjarlægðu einstök val eða veldu Hreinsa síur til að endurstilla spjaldið Síur. Þótt síur séu hreinsaðar er ekki skipt á milli greiningar verkefnis og fyrirtækis.
Notaðu Sía á grafinu Notkun til að sía eftir Lotuvinnsla. Veldu Endurstilla síur grafs til að endurstilla síur þess grafs.
Ef eiginleiki styður ekki valdar síur gætu gildi hans verið ótiltæk. Ótiltæk gildi þýða ekki að notkun sé engin.
Ef sía sýnir heimildavillu getur verið að þú hafir ekki aðgang að valkostum hennar. Þetta þýðir ekki að engin notkun hafi verið skráð.
Skoða notkun einstaks notanda
Opnaðu Notkun í Greining fyrir verkefnið eða fyrirtækið sem þú vilt skoða. Í töflunni Eiginleikar API skaltu velja Skoða við Svör og spjalllok.
Undir Síur skaltu velja Notendur og velja notandann. Niðurstöðurnar uppfærast strax.
Skoðaðu grafið og töfluna fyrir þann notanda.
Til að skoða notkun notanda á mismunandi eiginleikum skaltu nota síuna Notendur í yfirlitinu Notkun. Til að bera saman notendur skaltu hreinsa þá síu og velja töfluflipann Notendur.
Skoða tóka á dag, klukkustund eða mínútu
Þar sem hægt er að velja tímabilsskref í Notkun skaltu velja 1d eða 1h til að sjá tóka eftir degi eða klukkustund, eða 1m til að skoða tóka á mínútu (TPM). Veldu Sjálfvirkt til að láta mælaborðið velja tímabilsskref fyrir skýrslutímabilið þitt. Þessi tímabilsskref eiga við um notkunargögn, ekki reikningsgögn.
Ef 1m er óvirkt skaltu velja styttra skýrslutímabil eða nota Velja til að þysja inn og draga yfir grafið til að þrengja tímabilið. Veldu síðan 1m. Ýttu á Esc til að hætta við val á aðdráttarsvæði. Veldu núverandi dagsetningarbil á tækjastikunni í Greining til að velja annað skýrslutímabil.
Skoða notkunargröf og töflur
Notaðu Mælikvarðar til að velja eina eða fleiri gagnaraðir til að birta saman, þar á meðal Inntakstókar, Inntakstókar utan skyndiminnis, Inntakstókar í skyndiminni, Inntakstókar skrifaðir í skyndiminni, Hljóðtókar í inntaki, Úttakstókar og Hljóðtókar í úttaki. Hvaða mælikvarðar eru í boði fer eftir eiginleikanum. Notaðu skýringar grafsins til að bera kennsl á hverja gagnaröð.
Notaðu Flokka eftir til að flokka notkun eftir atriðum á borð við Verkefni, Notandi eða Líkan, þar sem það er í boði. Síur stýra því hvaða notkun er tekin með; flokkun stýrir því hvernig hún er birt. Skiptu á milli línu- og súlurita til að skoða þróun eða bera saman flokka.
Notaðu töfluflipana undir Notkun til að skoða þær sundurliðanir sem eru í boði. Töflur sýna viðeigandi mæligildi fyrir hverja línu, svo sem fjölda beiðna, inntaks- og úttakstóka eða einingar sem eiga við tiltekinn eiginleika.
Undir Eiginleikar API skaltu velja Skoða við eiginleika til að opna ítarleg gröf og sundurliðanir fyrir hann. Undir Svör og spjalllok eru aðskilin gröf fyrir Tóka og Beiðnir, auk mælikvarðans Beiðnir til líkana. Sundurliðunarfliparnir nota sömu flokkunarþætti og yfirlitið, en flipinn Eiginleikar API er ekki þar. Notaðu Notkun í leiðarstikunni til að fara aftur í yfirlitið.
Þegar þú hefur valið valkost undir Flokka eftir gæti grafið sameinað fleiri flokka undir Annað. Ef Annað birtist í skýringum grafsins skaltu velja þann lið til að sjá flokkana sem þar eru teknir saman og notkunargildi þeirra.
Veldu Bera saman mælaborð til að sjá Notkun við hlið annars mælaborðs fyrir sama skýrslutímabil. Notaðu Vinstra mælaborð og Hægra mælaborð til að velja yfirlitin. Ef valið tímabilsskref er ekki í boði fyrir bæði mælaborðin skiptir yfirlitið yfir í Sjálfvirkt. Veldu Hætta samanburði til að fara aftur á mælaborðið.
Kanna notkun sem þú kannast ekki við
Ef Notkun sýnir virkni sem þú getur ekki tengt við beiðnir í annálum forritsins þíns skaltu athuga eftirfarandi:
Staðfestu hvaða fyrirtæki, verkefni og skýrslutímabil eru valin. Notaðu UTC þegar þú berð tímastimpla á mælaborðinu saman við annála forritsins þíns.
Notaðu verkefnayfirlit viðkomandi verkefnis eða veldu það undir Verkefni í Greining fyrirtækis. Notaðu svo Síur til að afmarka notkun eftir API-lykli og líkani og veldu styttra skýrslutímabil.
Berðu virknina saman við annála fyrir sama tímabil, verkefni og API-lykil. Athugaðu hvort annálarnir nái yfir öll forrit eða samþættingar sem nota þann lykil.
Ef nokkur forrit eða samþættingar deila sama verkefni eða API-lykli er ekki víst að heildartalan ein og sér sýni hvaðan beiðni kom. Berðu mælaborðið saman við skráningar úr hverju forriti fyrir sama UTC-tímabil.
Ef þú getur enn ekki skýrt notkunina skaltu hafa samband við þjónustuver OpenAI og tilgreina viðkomandi UTC-tímabil, auðkenni fyrirtækis og verkefnis, auðkenni API-lykilsins og viðeigandi skjámyndir eða annála. Láttu auðkenni beiðna fylgja ef þau eru tiltæk. Ekki láta leynilega API-lykla fylgja.
Flytja út notkunargögn
Til að flytja út notkunargögn skaltu velja táknið Flytja út CSV á tækjastikunni í Greining og síðan Virknigögn.
Veldu Eiginleiki API og einn eða fleiri flokkunarþætti undir Flokka eftir.
Farðu yfir API-uppruni, Verkefni, Notendur, API-lyklar og Líkön. Val fyrir Verkefni og API-uppruni er sótt úr Greining; veldu aðrar útflutningssíur í svarglugganum.
Veldu Skráarsnið, Upphafstími, Lokatími og Tímabilsskref og veldu síðan Sækja. Dagsetningar ná yfir heila sólarhringa samkvæmt UTC.
Hægt er að skoða og flytja út virkni- og kostnaðargögn frá kl. 00:00 UTC fyrir einu almanaksári til dagsins í dag. Til að fá eldri gögn skaltu hafa samband við þjónustuver OpenAI. Dagleg gögn eru flutt út í skrám sem ná yfir 31 dag í senn.
Upplýsingar um afstemmingu mánaðarlegra reikninga og útflutning reikningsliða er að finna í: Flytja út mánaðarlegar notkunarupplýsingar.
Ef útflutt virknigögn innihalda línur með neikvæðum gildum skaltu bera saman línur með sömu einingu, flokkun og dagsetningum. Notaðu Kostnaðargögn til að sjá reikningsfærðar upphæðir. Neikvætt gildi í línu virknigagna staðfestir ekki eitt og sér að upphæð hafi verið færð til lækkunar á reikningnum þínum.
Skoða kostnað
Opnaðu Greining og veldu Kostnaður til að skoða kostnað núverandi verkefnis. Til að sjá kostnað fyrirtækisins í heild skaltu velja Greining fyrirtækis og síðan Kostnaður.
Athugaðu núverandi dagsetningarbil og síur áður en þú berð kostnað saman við notkun. Mismunandi síur eru í boði í Notkun og Kostnaður; sía sem er í boði á öðru mælaborðinu á ekki endilega við um hitt.
Notaðu API-uppruni, API-lyklar, Líkön og Reikningsliðir til að afmarka kostnað. Í greiningu fyrirtækis skaltu nota Verkefni til að taka með þau verkefni sem þú vilt skoða. Notaðu töfluflipana Reikningsliðir, API-lyklar, Notendur, Verkefni og Líkön til að sjá þær sundurliðanir sem eru í boði.
Ef gildi fyrir kostnaðarhámark er ótiltækt þýðir það ekki að hámarkið sé núll eða að nýtt hámark hafi tekið gildi. Aðgangsheimildir, óskilgreint hámark eða misheppnuð beiðni geta komið í veg fyrir að gildi birtist á mælaborðinu.
Skoða þjónustustöðu
Ef fyrirtækið þitt hefur aðgang að Þjónustustaða skaltu opna það mælaborð í Greining til að skoða afköst API. Upplýsingar um aðgangsskilyrði og skilgreiningar mælikvarða er að finna í: Úrræðaleit vegna API-villna og biðtíma.
Skoða úthlutaðar inneignir
Upplýsingar um úthlutaðar inneignir eru á reikningssíðu fyrirtækisins þíns.
Úthlutaðar inneignir og API-notkun veita ólíkar upplýsingar: úthlutaðar inneignir sýna inneignir sem tengjast fyrirtækinu þínu en notkun sýnir API-virkni þess.
Skoða notkun og kostnað Kvarðastigs
Ef Kvarðastig er virkt hjá fyrirtækinu þínu og þú ert með tilskilinn aðgang skaltu opna notkunarsíðu Kvarðastigs til að sjá ítarlegar notkunarupplýsingar.
Kostnaður vegna Kvarðastigspakka er færður á fyrirtækið en ekki einstök verkefni.
Notkun er meiri en núll en kostnaður verkefnis er núll
Athugaðu hvort notkun líkansins falli innan úthlutunar þinnar á Kvarðastigi. Ef öll notkun þess líkans er innan úthlutaðs TPM-kvóta á Kvarðastigi getur verkefnið sýnt notkun án viðbótarkostnaðar vegna líkansins.
Áskriftarkostnaður fyrir Kvarðastig er áfram færður á fyrirtækið. Skoðaðu kostnað fyrirtækisins í heild í stað þess að miða aðeins við kostnað einstaks verkefnis.
Skoða mörg fyrirtæki
Notkunarmælaborðið sameinar ekki kostnaðar- eða notkunargögn frá mörgum fyrirtækjum. Hvert fyrirtæki, einnig undirfyrirtæki, er meðhöndlað sérstaklega.
Til að skoða undirfyrirtæki skaltu velja það í fyrirtækjavalinu.
Ef þú þarft sameinaðar skýrslur skaltu íhuga að nota verkefni innan eins fyrirtækis í stað aðskilinna undirfyrirtækja, eða nota API fyrir notkun til að gera sérsniðna greiningu.
Athuga tókanotkun í API-svari
Heiti reita fyrir tókanotkun fara eftir endapunktinum.
| Tókafjöldi | Spjalllok | Svör |
|---|---|---|
| Inntakstókar | usage.prompt_tokens | usage.input_tokens |
| Úttakstókar | usage.completion_tokens | usage.output_tokens |
| Tókar alls | usage.total_tokens | usage.total_tokens |
Svör frá Spjalllokum geta innihaldið upplýsingar um tókanotkun. Dæmi um þetta eru:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Eftir því hvaða endapunktur og líkan eru notuð geta notkunarupplýsingar einnig sýnt fjölda tóka í skyndivistuðu inntaki og fjölda röktóka. Þessar upplýsingar hjálpa til við að skýra hvers vegna sýnileg lengd svars endurspeglar ekki alla tókanotkun þess.
Til að fá skýringu á mismunandi tókaflokkum, sjá: Að skilja og telja tóka.
Þegar svar við umritunarbeiðni tilgreinir tókanotkun eru inntakstókar fyrir hljóð og texta þegar innifaldir í input_tokens. Ekki bæta þessum hlutum aftur við heildarfjölda inntakstóka. Berðu output_tokens saman sérstaklega.
Sækja notkunarupplýsingar úr streymdum spjalllokum
Láttu eftirfarandi fylgja með beiðni um streymd spjalllok:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Þegar include_usage er virkjað kemur viðbótargagnabútur á undan data: [DONE] með notkunarupplýsingum fyrir alla beiðnina. Fylkið choices í honum er tómt. Í öðrum gagnabútum hefur usage gildið null.
Ef streymið rofnar er ekki víst að þú fáir þennan síðasta gagnabút með notkunarupplýsingunum. Þótt síðasta gagnabútinn vanti sannar það ekki að beiðnin hafi enga tóka notað.
Þessi stilling á aðeins við um spjalllok. Nánari upplýsingar er að finna í tilvísunarskjölum fyrir API fyrir spjalllok.
