Forbhreathnú
Is féidir leat úsáid API a athbhreithniú ar dhá bhealach:
Úsáid Anailísíocht > Úsáid chun gníomhaíocht API a athbhreithniú don tréimhse tuairiscithe reatha agus do thréimhsí roimhe seo.
Léigh an fhaisnéis úsáide i bhfreagra API chun iarratas aonair a sheiceáil.
Úsáideann Playground na glaonna API céanna le d'fheidhmchláir. Áirítear a théacschomharthaí in úsáid API do chuntais agus tá feidhm ag na rialacha úsáide agus an phraghsáil chéanna leo.
Rochtain ar an deais
Ní mór duit a bheith i d’úinéir eagraíochta nó an cead Deais Úsáide a bheith agat chun rochtain a fháil ar an Deais Úsáide.
Athbhreithnigh úsáid sa deais
San Ardán API, oscail Anailísíocht agus roghnaigh Úsáid chun an tionscadal reatha a athbhreithniú. Le haghaidh tuairisciú ar fud na heagraíochta, roghnaigh Anailísíocht na heagraíochta. Roghnaigh an tréimhse tuairiscithe is mian leat a athbhreithniú, agus seiceáil arís í tar éis duit athrú idir anailísíocht tionscadail agus anailísíocht eagraíochta.
Taispeántar sonraí na deaise in UTC. Coinnigh an crios ama sin i gcuimhne agus gníomhaíocht na deaise á cur i gcomparáid agat le logaí d'fheidhmchláir.
Seans go dtógfaidh sé tamall ar úsáid le déanaí a bheith le feiceáil sa deais. Má tá gníomhaíocht le déanaí ar iarraidh, seiceáil arís ar ball.
Scag úsáid
In Anailísíocht tionscadail, ní thaispeántar ach úsáid an tionscadail roghnaithe. In Anailísíocht na heagraíochta, úsáid Tionscadal chun na tionscadail is mian leat a athbhreithniú a roghnú. Cuimsíonn Gach tionscadal gach tionscadal san eagraíocht, faoi réir aon scagairí eile atá roghnaithe agat.
Úsáid Scagairí chun úsáid a chúngú de réir Foinsí API, Eochracha API, Samhlacha, Úsáideoirí nó Leibhéal próiseála. Le Foinsí API, is féidir leat Gach foinse API, API Gníomhairí nó API Díreach a roghnú.
Bain roghnúcháin aonair nó roghnaigh Glan scagairí chun an painéal Scagairí a athshocrú. Ní athraítear idir anailísíocht tionscadail agus anailísíocht eagraíochta nuair a ghlantar scagairí.
Úsáid Scag ar an gcairt Úsáid chun scagadh de réir Baisc. Roghnaigh Athshocraigh scagairí na cairte chun scagairí na cairte sin a athshocrú.
Mura dtacaíonn cumas leis na scagairí roghnaithe, seans nach mbeidh a luachanna ar fáil. Ní chiallaíonn luachanna nach bhfuil ar fáil nach raibh aon úsáid ann.
Má thaispeánann scagaire earráid cheada, seans nach bhfuil rochtain agat ar a roghanna. Ní chiallaíonn sé seo nár taifeadadh aon úsáid.
Athbhreithnigh úsáid úsáideora aonair
Oscail Úsáid in amharc Anailísíocht an tionscadail nó na heagraíochta is mian leat a athbhreithniú. Sa tábla Cumais API, roghnaigh Amharc le haghaidh Freagraí agus críochnuithe comhráite.
In Scagairí, roghnaigh Úsáideoirí agus roghnaigh an t-úsáideoir. Nuashonraítear na torthaí láithreach.
Athbhreithnigh an chairt agus an tábla don úsáideoir sin.
Chun úsáid úsáideora a athbhreithniú thar chumais éagsúla, cuir an scagaire Úsáideoirí i bhfeidhm ar fhorbhreathnú Úsáid. Chun úsáideoirí a chur i gcomparáid, glan an scagaire sin agus roghnaigh cluaisín an tábla Úsáideoirí.
Féach ar théacschomharthaí in aghaidh an lae, na huaire nó an nóiméid
Nuair atá rialuithe eatraimh ar fáil in Úsáid, roghnaigh 1 lá nó 1 uair chun téacschomharthaí a fheiceáil de réir lae nó uaire, nó 1 nóim chun téacschomharthaí in aghaidh an nóiméid (TPM) a scrúdú. Roghnaigh Uathoibríoch chun ligean don deais an t-eatramh ama a roghnú do do thréimhse tuairiscithe. Baineann na heatraimh seo le sonraí úsáide, ní le sonraí billeála.
Má tá 1 nóim díchumasaithe, roghnaigh tréimhse tuairiscithe níos giorra nó úsáid Roghnaigh chun zúmáil agus tarraing trasna na cairte chun an raon a chúngú. Ansin roghnaigh 1 nóim. Brúigh Esc chun roghnúchán zúmála a chealú. Roghnaigh an raon dátaí reatha sa bharra uirlisí Anailísíocht chun tréimhse tuairiscithe eile a roghnú.
Athbhreithnigh cairteacha agus táblaí úsáide
Úsáid Méadrachtaí chun sraith amháin nó níos mó a roghnú le taispeáint le chéile, lena n-áirítear Téacschomharthaí ionchuir, Téacschomharthaí ionchuir gan taisceadh, Téacschomharthaí ionchuir taiscthe, Téacschomharthaí ionchuir a scríobhtar sa taisce, Téacschomharthaí fuaime ionchuir, Téacschomharthaí aschuir agus Téacschomharthaí fuaime aschuir. Braitheann na méadrachtaí atá ar fáil ar an gcumas. Úsáid an eochair chun gach sraith a aithint.
Úsáid Grúpáil de réir chun úsáid a eagrú de réir catagóirí amhail Tionscadal, Úsáideoir nó Samhail, nuair atá siad ar fáil. Rialaíonn scagairí an úsáid a chuirtear san áireamh; rialaíonn grúpáil an chaoi a dtaispeántar í. Athraigh idir línechairteacha agus barrachairteacha chun treochtaí a scrúdú nó catagóirí a chur i gcomparáid.
Úsáid cluaisíní an tábla Úsáid chun na miondealuithe atá ar fáil a athbhreithniú. Taispeánann na táblaí na tomhais ábhartha do gach ró, amhail iarratais, téacschomharthaí ionchuir agus aschuir, nó aonaid a bhaineann go sonrach leis an gcumas.
In Cumais API, roghnaigh Amharc do chumas chun na cairteacha mionsonraithe agus na miondealuithe a bhaineann leis a oscailt. Áirítear in Freagraí agus críochnuithe comhráite cairteacha ar leith do Théacschomharthaí agus Iarratais, chomh maith le méadracht Iarratais ar shamhlacha. Úsáideann a chluaisíní miondealaithe na toisí céanna leis an bhforbhreathnú, ach gan an cluaisín Cumais API. Úsáid an nasc Úsáid sa rian nascleanúna chun filleadh ar an bhforbhreathnú.
Tar éis rogha Grúpáil de réir a roghnú, féadfaidh an chairt catagóirí breise a chur le chéile faoi Eile. Má tá Eile le feiceáil in eochair na cairte, roghnaigh an lipéad sin chun na catagóirí atá san áireamh agus a luachanna úsáide a fheiceáil.
Roghnaigh Cuir deaiseanna i gcomparáid chun Úsáid a fheiceáil taobh le deais eile don tréimhse tuairiscithe chéanna. Úsáid Deais ar chlé agus Deais ar dheis chun na hamhairc a roghnú. Mura bhfuil an t-eatramh ama roghnaithe ar fáil don dá dheais, athraítear an t-amharc go Uathoibríoch. Roghnaigh Scoir den chomparáid chun filleadh ar an deais.
Fiosraigh úsáid nach n-aithníonn tú
Má thaispeánann Úsáid gníomhaíocht nach féidir leat a mheaitseáil le hiarratais i logaí d'fheidhmchláir, déan na seiceálacha seo:
Deimhnigh an eagraíocht, raon feidhme na dtionscadal agus an tréimhse tuairiscithe. Úsáid UTC agus stampaí ama na deaise á gcur i gcomparáid agat le logaí d'fheidhmchláir.
Úsáid amharc an tionscadail lena mbaineann, nó roghnaigh é faoi Tionscadal in Anailísíocht na heagraíochta. Ansin úsáid Scagairí chun an úsáid a chúngú de réir eochrach API agus samhla, agus roghnaigh tréimhse tuairiscithe níos giorra.
Cuir an ghníomhaíocht i gcomparáid le logaí don tréimhse, don tionscadal agus don eochair API chéanna. Seiceáil an gclúdaíonn do logaí gach feidhmchlár nó comhtháthú a úsáideann an eochair sin.
Má tá an tionscadal nó an eochair API chéanna á roinnt ag roinnt feidhmchlár nó comhtháthuithe, b'fhéidir nach leor an t-iomlán leis féin chun a aithint cé acu a sheol iarratas. Cuir an deais i gcomparáid le taifid ó gach feidhmchlár don tréimhse UTC chéanna.
Mura féidir leat an úsáid a mhíniú fós, déan teagmháil le Tacaíocht OpenAI agus cuir ar fáil an tréimhse UTC lena mbaineann, aitheantóirí na heagraíochta agus an tionscadail, aitheantóir na heochrach API, agus gabhálacha scáileáin nó logaí ábhartha. Cuir aitheantóirí iarratais san áireamh má tá siad ar fáil. Ná cuir eochracha rúnda API san áireamh.
Easpórtáil sonraí úsáide
Chun úsáid a easpórtáil, roghnaigh an deilbhín Easpórtáil CSV sa bharra uirlisí Anailísíocht, ansin roghnaigh Sonraí gníomhaíochta.
Roghnaigh an Cumas API agus toise amháin nó níos mó faoi Grúpáil de réir.
Athbhreithnigh Foinse API, Tionscadail, Úsáideoirí, Eochracha API agus Samhlacha. Bíonn Tionscadail agus Foinse API réamhroghnaithe de réir Anailísíocht; roghnaigh na scagairí easpórtála eile sa dialóg.
Roghnaigh Formáid comhaid, Am tosaithe, Am deiridh agus Eatramh ama, ansin roghnaigh Íoslódáil. Cuimsíonn dátaí laethanta iomlána UTC.
Tá sonraí gníomhaíochta agus costais ar fáil le féachaint orthu agus le heaspórtáil ó 00:00 UTC bliain féilire ó shin go dtí an lá inniu. Le haghaidh sonraí níos sine, déan teagmháil le Tacaíocht OpenAI. Easpórtáiltear sonraí laethúla i gcomhaid a chlúdaíonn tréimhsí 31 lá.
Maidir le réiteach sonrasc míosúil agus easpórtálacha míreanna líne, féach: Sonraí úsáide míosúla a easpórtáil.
Má tá rónna diúltacha in easpórtáil Gníomhaíochta, cuir i gcomparáid na rónna a bhfuil an t-aonad, an ghrúpáil agus na dátaí céanna acu. Úsáid Sonraí costais le haghaidh méideanna a cuireadh ar bhille. Ní chruthaíonn ró gníomhaíochta diúltach leis féin gur cuireadh creidmheas i leith do shonraisc.
Athbhreithnigh caiteachas
Oscail Anailísíocht agus roghnaigh Caiteachas chun costais an tionscadail reatha a athbhreithniú. Le haghaidh costais ar fud na heagraíochta, roghnaigh Anailísíocht na heagraíochta agus ansin Caiteachas.
Seiceáil an raon dátaí reatha agus na scagairí sula gcuirfidh tú costais i gcomparáid le húsáid. Tá scagairí éagsúla ar fáil in Úsáid agus Caiteachas; seans nach mbeidh scagaire atá ar fáil i ndeais amháin infheidhme sa cheann eile.
Úsáid Foinsí API, Eochracha API, Samhlacha agus Míreanna líne chun an caiteachas a chúngú. In anailísíocht na heagraíochta, úsáid Tionscadal chun na tionscadail is mian leat a athbhreithniú a chur san áireamh. Úsáid cluaisíní an tábla Míreanna líne, Eochracha API, Úsáideoirí, Tionscadail agus Samhlacha le haghaidh na miondealuithe atá ar fáil.
Mura bhfuil luach na teorann caiteachais ar fáil, ní chiallaíonn sé sin gur nialas do theorainn ná gur cuireadh teorainn nua i bhfeidhm. Féadfaidh ceadanna rochtana, teorainn nár socraíodh, nó iarratas ar theip air cosc a chur ar an deais luach a thaispeáint.
Athbhreithnigh sláinte na seirbhíse
Má tá rochtain ag d'eagraíocht ar Sláinte na seirbhíse, oscail an deais sin in Anailísíocht chun feidhmíocht API a athbhreithniú. Le haghaidh incháilitheachta agus sainmhínithe ar mhéadrachtaí, féach: Fabhtcheartú earráidí API agus aga folaigh.
Féach ar dheontais creidmheasanna
Tá sonraí faoi dheontais creidmheasanna ar fáil ar leathanach Billeála d'eagraíochta.
Freagraíonn deontais creidmheasanna agus úsáid API ceisteanna éagsúla: taispeánann deontais creidmheasanna na creidmheasanna a bhaineann le d'eagraíocht, agus taispeánann úsáid a gníomhaíocht API.
Athbhreithnigh úsáid agus costais an Leibhéil Scálaithe
Má tá Leibhéal Scálaithe cumasaithe ag d’eagraíocht agus an rochtain riachtanach agat, oscail leathanach úsáide an Leibhéil Scálaithe chun sonraí úsáide a fháil.
Cuirtear costais bheart an Leibhéil Scálaithe i leith na heagraíochta, ní i leith tionscadail aonair.
Tá úsáid os cionn nialais, ach tá caiteachas an tionscadail ag nialas
Seiceáil an bhfuil úsáid na samhla clúdaithe ag do leithdháileadh Leibhéal Scálaithe. Má tá úsáid uile na samhla sin laistigh de leithdháileadh TPM an Leibhéil Scálaithe, féadfaidh an tionscadal úsáid a thaispeáint gan caiteachas breise ar an tsamhail.
Fanann costas síntiúis an Leibhéil Scálaithe ar leibhéal na heagraíochta. Athbhreithnigh caiteachas na heagraíochta ar fad seachas brath ar chaiteachas tionscadail aonair.
Athbhreithnigh eagraíochtaí éagsúla
Ní chuireann an Deais Úsáide sonraí costais ná úsáide ó eagraíochtaí éagsúla le chéile. Caitear le gach eagraíocht ar leithligh, fo-eagraíochtaí san áireamh.
Chun fo-eagraíocht a fheiceáil, roghnaigh í sa roghnóir eagraíochta.
Má theastaíonn tuairisciú comhcheangailte uait, smaoinigh ar thionscadail laistigh d'aon eagraíocht amháin a úsáid in ionad fo-eagraíochtaí ar leith, nó úsáid an API Úsáide le haghaidh anailís shaincheaptha.
Seiceáil úsáid téacschomharthaí i bhfreagra API
Braitheann ainmneacha na réimsí úsáide téacschomharthaí ar an deireadhphointe.
| Líon téacschomharthaí | Críochnuithe comhráite | Freagraí |
|---|---|---|
| Téacschomharthaí ionchuir | usage.prompt_tokens | usage.input_tokens |
| Téacschomharthaí aschuir | usage.completion_tokens | usage.output_tokens |
| Téacschomharthaí iomlána | usage.total_tokens | usage.total_tokens |
Is féidir faisnéis faoi úsáid téacschomharthaí a bheith i bhfreagraí Críochnuithe comhráite. Seo roinnt samplaí:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Ag brath ar an deireadhphointe agus ar an tsamhail, féadfar líon na dtéacschomharthaí ionchuir i dtaisce agus na dtéacschomharthaí réasúnaíochta a áireamh sna sonraí úsáide freisin. Cabhraíonn na sonraí sin lena mhíniú cén fáth nach léiríonn fad infheicthe freagra líon iomlán na dtéacschomharthaí a úsáideadh.
Chun míniú a fháil ar na catagóirí éagsúla téacschomharthaí, féach: Téacschomharthaí a thuiscint agus a chomhaireamh.
I bhfreagra trascríofa a thuairiscíonn úsáid téacschomharthaí, tá na téacschomharthaí ionchuir fuaime agus téacs san áireamh in input_tokens cheana féin. Ná cuir na comhpháirteanna sin leis an iomlán ionchuir arís. Déan comparáid idir luachanna output_tokens ar leithligh.
Faigh sonraí úsáide ó Chríochnuithe comhráite sruthaithe
Le haghaidh iarratas sruthaithe ar Chríochnuithe comhráite, cuir an méid seo a leanas san áireamh:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Nuair atá include_usage cumasaithe, bíonn sonraí úsáide an iarratais iomláin i smután breise roimh data: [DONE]. Tá a eagar choices folamh. Is é null luach usage sna smutáin eile.
Má chuirtear isteach ar an sruth, seans nach bhfaighidh tú an smután deiridh sin ina bhfuil na sonraí úsáide. Má tá an smután deiridh ar iarraidh, ní chruthaíonn sé sin nár úsáideadh aon téacschomharthaí san iarratas.
Baineann an chumraíocht seo go sonrach le Críochnuithe comhráite. Le haghaidh sonraí, féach: Treoir thagartha API críochnuithe comhráite.