Pangkalahatang-ideya
Maaari mong suriin ang paggamit ng API sa dalawang paraan:
Gamitin ang Analitika > Paggamit para suriin ang aktibidad ng API sa kasalukuyan at mga nakaraang panahon ng pag-uulat.
Basahin ang impormasyon ng paggamit sa isang tugon ng API para suriin ang isang partikular na request.
Pareho ang mga API call na ginagamit ng Playground at ng mga application mo. Kasama ang mga token nito sa paggamit ng API ng account mo, at saklaw ang mga ito ng parehong mga tuntunin sa paggamit at pagpepresyo.
Access sa dashboard
Dapat ay may-ari ka ng organisasyon o mayroon kang pahintulot sa Dashboard ng Paggamit para ma-access ito.
Suriin ang paggamit sa dashboard
Sa API Platform, buksan ang Analitika at piliin ang Paggamit para suriin ang kasalukuyang proyekto. Para sa pag-uulat sa buong organisasyon, piliin ang Analitika ng organisasyon. Piliin ang panahon ng pag-uulat na gusto mong suriin, at tingnan itong muli pagkatapos lumipat sa analitika ng proyekto o organisasyon.
Ipinapakita sa UTC ang datos ng dashboard. Isaisip ang time zone na iyon kapag inihahambing ang aktibidad sa dashboard sa mga log ng application mo.
Maaaring matagalan bago lumabas sa dashboard ang kamakailang paggamit. Kung hindi lumalabas ang kamakailang aktibidad, tingnan muli sa ibang pagkakataon.
I-filter ang paggamit
Sa Analitika ng proyekto, ang napiling proyekto lang ang saklaw ng paggamit. Sa Analitika ng organisasyon, gamitin ang Proyekto para piliin ang mga proyektong gusto mong suriin. Kasama sa Lahat ng proyekto ang bawat proyekto sa organisasyon, na napapailalim sa iba pang filter na pinili mo.
Gamitin ang Mga filter para limitahan ang ipinapakitang paggamit ayon sa Mga pinagmulan ng API, Mga API key, Mga modelo, Mga user, o Antas ng pagproseso. Sa Mga pinagmulan ng API, maaari mong piliin ang Lahat ng pinagmulan ng API, Agents API, o Direktang API.
Alisin ang mga napili nang paisa-isa o piliin ang I-clear ang mga filter para i-reset ang panel ng Mga filter. Hindi nagpapalipat sa analitika ng proyekto at organisasyon ang pag-clear ng mga filter.
Gamitin ang Filter sa chart ng Paggamit para mag-filter ayon sa Batch. Piliin ang I-reset ang mga filter ng chart para i-reset ang mga filter ng chart na iyon.
Kung hindi sinusuportahan ng isang kakayahan ang mga napiling filter, maaaring hindi available ang mga halaga nito. Ang mga halagang hindi available ay hindi nangangahulugang walang paggamit.
Kung nagpapakita ang isang filter ng error sa pahintulot, maaaring wala kang access sa mga opsyon nito. Hindi ito nangangahulugang walang naitalang paggamit.
Suriin ang paggamit ng isang user
Buksan ang Paggamit sa view ng Analitika ng proyekto o organisasyong gusto mong suriin. Sa talahanayan ng Mga kakayahan ng API, piliin ang Tingnan para sa Responses at chat completions.
Sa Mga filter, piliin ang Mga user at piliin ang user. Agad na naa-update ang mga resulta.
Suriin ang chart at talahanayan para sa user na iyon.
Para suriin ang paggamit ng isang user sa iba't ibang kakayahan, ilapat ang filter na Mga user sa pangkalahatang-ideya ng Paggamit. Para paghambingin ang mga user, i-clear ang filter na iyon at piliin ang tab na Mga user sa talahanayan.
Tingnan ang mga token kada araw, oras, o minuto
Kung may mga kontrol sa agwat sa Paggamit, piliin ang 1d o 1h para tingnan ang mga token kada araw o oras, o 1m para suriin ang mga token kada minuto (TPM). Piliin ang Awtomatiko para hayaan ang dashboard na pumili ng agwat ng oras para sa iyong panahon ng pag-uulat. Nalalapat ang mga agwat na ito sa datos ng paggamit, hindi sa datos ng pagsingil.
Kung naka-disable ang 1m, pumili ng mas maikling panahon ng pag-uulat o gamitin ang Pumili para mag-zoom at mag-drag sa chart para paliitin ang saklaw. Pagkatapos, piliin ang 1m. Pindutin ang Esc para kanselahin ang napiling bahaging izu-zoom. Piliin ang kasalukuyang saklaw ng petsa sa toolbar ng Analitika para pumili ng ibang panahon ng pag-uulat.
Suriin ang mga chart at talahanayan ng paggamit
Gamitin ang Mga sukatan para pumili ng isa o higit pang serye ng datos na sabay na ipapakita, kabilang ang Mga input token, Mga input token na hindi naka-cache, Mga naka-cache na input token, Mga input token sa pagsulat sa cache, Mga input audio token, Mga output token, at Mga output audio token. Nakadepende sa kakayahan ang mga available na sukatan. Gamitin ang legend para matukoy ang bawat serye ng datos.
Gamitin ang Ipangkat ayon sa para ayusin ang paggamit ayon sa mga kategorya tulad ng Proyekto, User, o Modelo, kung available. Tinutukoy ng mga filter kung aling paggamit ang isasama; tinutukoy naman ng pagpapangkat kung paano ito ipapakita. Magpalipat-lipat sa line chart at bar chart para suriin ang mga trend o paghambingin ang mga kategorya.
Gamitin ang mga tab ng talahanayan ng Paggamit para suriin ang mga available na detalye ayon sa kategorya. Ipinapakita ng mga talahanayan ang mga kaugnay na sukatan para sa bawat row, tulad ng mga request, input at output token, o mga unit na partikular sa kakayahan.
Sa Mga kakayahan ng API, piliin ang Tingnan para sa isang kakayahan upang buksan ang mga detalyadong chart at detalye nito ayon sa kategorya. Kasama sa Responses at chat completions ang magkahiwalay na chart para sa Mga token at Mga request, at ang sukatang Mga request sa modelo. Ginagamit ng mga tab nito para sa mga detalye ang parehong mga dimensyon na nasa pangkalahatang-ideya, pero wala ang tab na Mga kakayahan ng API. Gamitin ang breadcrumb na Paggamit para bumalik sa pangkalahatang-ideya.
Pagkatapos pumili ng opsyon sa Ipangkat ayon sa, maaaring pagsamahin ng chart ang mga karagdagang kategorya sa Iba pa. Kung may Iba pa sa legend ng chart, piliin ang label nito para makita ang mga kasamang kategorya at ang dami ng paggamit sa mga ito.
Piliin ang Paghambingin ang mga dashboard para makita ang Paggamit katabi ng isa pang dashboard para sa parehong panahon ng pag-uulat. Gamitin ang Kaliwang dashboard at Kanang dashboard para piliin ang mga view. Kung hindi available para sa pares ng dashboard ang napiling agwat ng oras, lilipat ang view sa Awtomatiko. Piliin ang Lumabas sa paghahambing para bumalik sa dashboard.
Imbestigahan ang paggamit na hindi mo nakikilala
Kung may aktibidad sa Paggamit na hindi mo maitugma sa mga request sa mga log ng application mo, suriin ang mga sumusunod:
Tiyaking tama ang organisasyon, saklaw ng proyekto, at panahon ng pag-uulat. Gamitin ang UTC kapag inihahambing ang mga timestamp sa dashboard sa mga log ng application mo.
Gamitin ang project view para sa apektadong proyekto, o piliin ito sa ilalim ng Proyekto sa Analitika ng organisasyon. Pagkatapos, gamitin ang Mga filter para limitahan ang ipinapakitang paggamit ayon sa API key at modelo, at pumili ng mas maikling panahon ng pag-uulat.
Ihambing ang aktibidad sa mga log para sa parehong panahon, proyekto, at API key. Tingnan kung saklaw ng mga log mo ang lahat ng application o integration na gumagamit ng key na iyon.
Kung iisang proyekto o API key ang ginagamit ng ilang application o integration, maaaring hindi matukoy sa kabuuang bilang lang kung alin ang nagpadala ng request. Ihambing ang dashboard sa mga tala ng bawat application para sa parehong panahon sa UTC.
Kung hindi mo pa rin maipaliwanag ang paggamit, makipag-ugnayan sa Suporta ng OpenAI at ibigay ang apektadong panahon sa UTC, mga ID ng organisasyon at proyekto, ang identifier ng API key, at mga kaugnay na screenshot o log. Isama ang mga request ID kung available. Huwag isama ang mga lihim na API key.
I-export ang datos ng paggamit
Para i-export ang paggamit, piliin ang icon na I-export bilang CSV sa toolbar ng Analitika, pagkatapos ay piliin ang Datos ng aktibidad.
Piliin ang Kakayahan ng API at isa o higit pang dimensyon sa Ipangkat ayon sa.
Suriin ang Pinagmulan ng API, Mga proyekto, Mga user, Mga API key, at Mga modelo. Nakapili na ang Mga proyekto at Pinagmulan ng API batay sa Analitika; piliin sa dialog ang iba pang filter sa pag-export.
Piliin ang Format ng file, Oras ng simula, Oras ng pagtatapos, at Agwat ng oras, pagkatapos ay piliin ang I-download. Saklaw ng mga petsa ang buong araw sa UTC.
Maaaring tingnan at i-export ang datos ng aktibidad at gastos mula 00:00 UTC noong kaparehong petsa isang taon na ang nakalipas hanggang ngayon. Para sa mas lumang datos, makipag-ugnayan sa Suporta ng OpenAI. Ine-export ang pang-araw-araw na datos sa mga file na may tig-31 araw na saklaw.
Para sa pagtutugma ng buwanang invoice at pag-export ng mga indibidwal na item, tingnan ang: Pag-export ng mga detalye ng buwanang paggamit.
Kung may mga row na negatibo ang halaga sa na-export na Aktibidad, ihambing ang mga row na may parehong unit, pagpapangkat, at mga petsa. Gamitin ang Datos ng gastos para sa mga halagang siningil. Hindi sapat ang isang row ng aktibidad na negatibo ang halaga para masabing may halagang ibinalik sa iyong invoice.
Suriin ang gastos
Buksan ang Analitika at piliin ang Gastos para suriin ang mga gastos ng kasalukuyang proyekto. Para sa mga gastos ng buong organisasyon, piliin ang Analitika ng organisasyon at pagkatapos ay Gastos.
Tingnan ang kasalukuyang saklaw ng petsa at mga filter bago ihambing ang gastos sa paggamit. Magkaiba ang mga filter sa Paggamit at Gastos; maaaring hindi naaangkop sa isang dashboard ang filter na available sa isa pa.
Gamitin ang Mga pinagmulan ng API, Mga API key, Mga modelo, at Mga indibidwal na item para limitahan ang ipinapakitang gastos. Sa analitika ng organisasyon, gamitin ang Proyekto para isama ang mga proyektong gusto mong suriin. Gamitin ang mga tab na Mga indibidwal na item, Mga API key, Mga user, Mga proyekto, at Mga modelo sa talahanayan para sa mga available na detalye ayon sa kategorya.
Kung hindi available ang halaga ng limitasyon sa gastos, hindi ito nangangahulugang zero ang limitasyon mo o may bagong limitasyong inilapat. Maaaring hindi magpakita ng halaga ang dashboard dahil sa mga pahintulot sa access, limitasyong hindi pa naitakda, o nabigong request.
Suriin ang kalagayan ng serbisyo
Kung may access ang organisasyon mo sa Kalagayan ng serbisyo, buksan ang dashboard na iyon sa Analitika para suriin ang performance ng API. Para sa mga pamantayan sa pagiging kwalipikado at kahulugan ng mga sukatan, tingnan ang: Pag-troubleshoot ng mga error at latency ng API.
Tingnan ang mga ipinagkaloob na credits
Available ang mga detalye ng mga ipinagkaloob na credits sa pahina ng Pagsingil ng organisasyon mo.
Magkaibang tanong ang sinasagot ng mga ipinagkaloob na credits at paggamit ng API: ipinapakita ng mga ipinagkaloob na credits ang credits na nauugnay sa organisasyon mo, samantalang ipinapakita ng paggamit ang aktibidad nito sa API.
Suriin ang paggamit at mga gastos sa Antas ng Scale
Kung naka-enable ang Antas ng Scale para sa iyong organisasyon at mayroon kang kinakailangang access, buksan ang page ng paggamit sa Antas ng Scale para sa detalyadong paggamit.
Iniuugnay sa organisasyon, hindi sa mga indibidwal na proyekto, ang mga gastos sa bundle ng Antas ng Scale.
May paggamit, pero zero ang gastos ng proyekto
Tingnan kung saklaw ng iyong alokasyon sa Antas ng Scale ang paggamit sa modelo. Kung pasok sa alokasyon ng TPM sa Antas ng Scale ang lahat ng paggamit sa modelong iyon, maaaring magpakita ang proyekto ng paggamit nang walang karagdagang gastos sa modelo.
Nananatili sa antas ng organisasyon ang gastos sa subscription sa Antas ng Scale. Suriin ang gastos ng buong organisasyon sa halip na umasa sa gastos ng isang proyekto lang.
Suriin ang maraming organisasyon
Hindi pinagsasama ng Dashboard ng Paggamit ang datos ng gastos o paggamit mula sa iba't ibang organisasyon. Hiwalay na tinatrato ang bawat organisasyon, kabilang ang mga sub-organisasyon.
Para makita ang isang sub-organisasyon, piliin ito sa tagapili ng organisasyon.
Kung kailangan mo ng pinagsamang pag-uulat, isaalang-alang ang paggamit ng mga proyekto sa iisang organisasyon sa halip na magkakahiwalay na sub-organisasyon, o gamitin ang Usage API para sa pasadyang pagsusuri.
Tingnan ang paggamit ng token sa isang tugon ng API
Nakadepende sa endpoint ang mga pangalan ng field para sa paggamit ng token.
| Bilang ng token | Chat Completions | Responses |
|---|---|---|
| Mga input token | usage.prompt_tokens | usage.input_tokens |
| Mga output token | usage.completion_tokens | usage.output_tokens |
| Kabuuang token | usage.total_tokens | usage.total_tokens |
Maaaring may impormasyon tungkol sa paggamit ng token sa mga tugon ng Chat Completions. Kabilang sa mga halimbawa ang:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Depende sa endpoint at modelo, maaari ding kasama sa mga detalye ng paggamit ang bilang ng mga token para sa naka-cache na input at pangangatwiran. Nakakatulong ang mga ito na ipaliwanag kung bakit hindi makikita sa haba ng tugon ang kabuuang paggamit nito ng token.
Para sa paliwanag tungkol sa iba't ibang kategorya ng token, tingnan ang: Pag-unawa at pagbibilang ng mga token.
Sa isang tugon sa transkripsiyon na nag-uulat ng paggamit ng token, kasama na sa input_tokens ang mga input token para sa audio at text. Huwag nang idagdag muli ang mga bahaging iyon sa kabuuang input. Ihambing nang hiwalay ang output_tokens.
Kunin ang datos ng paggamit mula sa naka-stream na Chat Completions
Para sa isang streaming na request sa Chat Completions, isama ang:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Kapag naka-enable ang include_usage, may dagdag na chunk bago ang data: [DONE] na naglalaman ng datos ng paggamit para sa buong request. Walang laman ang choices array nito. Sa ibang chunk, null ang value ng usage.
Kung maputol ang stream, maaaring hindi mo matanggap ang huling chunk na iyon na may datos ng paggamit. Ang pagkawala ng huling chunk ay hindi patunay na walang nagamit na token ang request.
Para lang sa Chat Completions ang configuration na ito. Para sa mga detalye, tingnan ang: Sanggunian ng chat completions API.
