Áttekintés
Az API-használatot kétféleképpen tekintheted át:
Az Analitika > Használat oldalon áttekintheted az aktuális és korábbi jelentési időszakok API-tevékenységét.
Egy adott kérés ellenőrzéséhez olvasd el az API-válaszban szereplő használati információkat.
A Playground ugyanazokat az API-hívásokat használja, mint az alkalmazásaid. A tokenjei beleszámítanak a fiókod API-használatába, és ugyanazok a használati szabályok és díjak vonatkoznak rájuk.
Hozzáférés az irányítópulthoz
A Használati irányítópult eléréséhez szervezettulajdonosnak kell lennie, vagy rendelkeznie kell a Használati irányítópult jogosultsággal.
Használati adatok áttekintése az irányítópulton
Az API Platform felületén nyisd meg az Analitika nézetet, és válaszd a Használat lehetőséget az aktuális projekt áttekintéséhez. A teljes szervezetre kiterjedő jelentésekhez válaszd a Szervezeti analitika lehetőséget. Válaszd ki az áttekinteni kívánt jelentési időszakot, és ellenőrizd újra, miután váltottál a projekt- és a szervezeti analitika között.
Az irányítópult adatai UTC-idő szerint jelennek meg. Vedd figyelembe ezt az időzónát, amikor az irányítópulton látható tevékenységet az alkalmazásnaplókkal hasonlítod össze.
Eltarthat egy ideig, amíg a legutóbbi használat megjelenik az irányítópulton. Ha a legutóbbi tevékenység hiányzik, ellenőrizd újra később.
Használati adatok szűrése
A projekt Analitika nézetében a használati adatok a kiválasztott projektre korlátozódnak. A Szervezeti analitika nézet Projekt menüjében választhatod ki az áttekinteni kívánt projekteket. Az Összes projekt a szervezet minden projektjét tartalmazza, a többi kiválasztott szűrő figyelembevételével.
A Szűrők segítségével az API-források, API-kulcsok, Modellek, Felhasználók vagy a Feldolgozási szint szerint szűkítheted a használati adatokat. Az API-források menüben az Összes API-forrás, az Agents API vagy a Közvetlen API lehetőséget választhatod.
Távolítsd el az egyes kijelöléseket, vagy válaszd a Szűrők törlése lehetőséget a Szűrők panel alaphelyzetbe állításához. A szűrők törlése nem vált a projekt- és a szervezeti analitika között.
A Használat diagram Szűrő menüjében a Kötegelt feldolgozás szerint szűrhetsz. A diagram szűrőinek alaphelyzetbe állításához válaszd a Diagramszűrők visszaállítása lehetőséget.
Ha egy funkció nem támogatja a kiválasztott szűrőket, előfordulhat, hogy az értékei nem érhetők el. A nem elérhető értékek nem jelentenek nulla használatot.
Ha egy szűrő jogosultsági hibát jelez, előfordulhat, hogy nincs hozzáférésed a beállításaihoz. Ez nem jelenti azt, hogy nem rögzítettek használati adatokat.
Egy adott felhasználó használati adatainak áttekintése
Nyisd meg a Használat oldalt a vizsgálni kívánt projekt vagy szervezet Analitika nézetében. Az API-funkciók táblázatban válaszd a Megtekintés lehetőséget a Válaszok és csevegés-befejezések sorában.
A Szűrők panelen válaszd a Felhasználók lehetőséget, majd válaszd ki a felhasználót. Az eredmények azonnal frissülnek.
Tekintsd át az adott felhasználó diagramját és táblázatát.
Ha egy felhasználó használatát több funkción át szeretnéd áttekinteni, alkalmazd a Felhasználók szűrőt a Használat áttekintő oldalán. A felhasználók összehasonlításához töröld ezt a szűrőt, és válaszd a táblázat Felhasználók fülét.
Tokenek megtekintése napi, óránkénti vagy percenkénti bontásban
Ahol a Használat nézetben elérhetők az időköz beállításai, válaszd az 1 n vagy az 1 ó lehetőséget a tokenek napi vagy óránkénti megtekintéséhez, illetve az 1 p lehetőséget a percenkénti tokenszám (TPM) vizsgálatához. Válaszd az Automatikus lehetőséget, hogy az irányítópult válassza ki a jelentési időszakhoz illő időközt. Ezek az időközök a használati adatokra vonatkoznak, nem a számlázási adatokra.
Ha az 1 p lehetőség le van tiltva, válassz rövidebb jelentési időszakot, vagy használd a Nagyítás kijelöléssel lehetőséget, és húzással jelölj ki egy szűkebb tartományt a diagramon. Ezután válaszd az 1 p lehetőséget. A nagyításhoz végzett kijelölés megszakításához nyomd meg az Esc billentyűt. Másik jelentési időszak kiválasztásához kattints az aktuális dátumtartományra az Analitika eszköztárán.
Használati diagramok és táblázatok áttekintése
A Mutatók menüben választhatsz ki egy vagy több, együtt megjelenítendő adatsort: Bemeneti tokenek, Nem gyorsítótárazott bemeneti tokenek, Gyorsítótárazott bemeneti tokenek, Gyorsítótárba írt bemeneti tokenek, Bemeneti hangtokenek, Kimeneti tokenek és Kimeneti hangtokenek. Az elérhető mutatók az adott funkciótól függenek. Az egyes adatsorokat a jelmagyarázat alapján azonosíthatod.
A Csoportosítás menüvel az elérhető kategóriák, például Projekt, Felhasználó vagy Modell szerint rendezheted a használati adatokat. A szűrők határozzák meg, mely használati adatok szerepeljenek, a csoportosítás pedig a megjelenítésüket szabályozza. Válts a vonal- és oszlopdiagramok között a trendek vizsgálatához vagy a kategóriák összehasonlításához.
A Használat táblázat fülein tekintheted át az elérhető bontásokat. A táblázatok minden sorban a vonatkozó mutatókat jelenítik meg, például a kéréseket, a bemeneti és kimeneti tokeneket vagy a funkcióspecifikus egységeket.
Az API-funkciók táblázatban válaszd a Megtekintés lehetőséget az adott funkciónál a részletes diagramok és bontások megnyitásához. A Válaszok és csevegés-befejezések külön Tokenek és Kérések diagramot, valamint egy Modellkérések mutatót tartalmaz. A bontások fülei az áttekintésével megegyező dimenziókat használnak, az API-funkciók fül nélkül. A navigációs útvonal Használat elemével térhetsz vissza az áttekintéshez.
Egy Csoportosítás beállítás kiválasztása után a diagram a további kategóriákat az Egyéb kategóriába vonhatja össze. Ha a diagram jelmagyarázatában megjelenik az Egyéb kategória, válaszd ki a címkéjét a benne szereplő kategóriák és használati értékeik megtekintéséhez.
Válaszd az Irányítópultok összehasonlítása lehetőséget, hogy a Használat nézetet egy másik irányítópult mellett, ugyanarra a jelentési időszakra jelenítsd meg. A nézeteket a Bal oldali irányítópult és a Jobb oldali irányítópult menüben választhatod ki. Ha a kiválasztott időköz nem érhető el az irányítópultpárhoz, a nézet Automatikus beállításra vált. Az irányítópultra való visszatéréshez válaszd a Kilépés az összehasonlításból lehetőséget.
Ismeretlen eredetű használat kivizsgálása
Ha a Használat nézetben olyan tevékenység látható, amelyet nem tudsz az alkalmazásnaplókban szereplő kérésekhez rendelni, végezd el az alábbi ellenőrzéseket:
Ellenőrizd a szervezetet, az érintett projektek körét és a jelentési időszakot. UTC-időt használj, amikor az irányítópult időbélyegeit az alkalmazásnaplókkal hasonlítod össze.
Használd az érintett projekt projektnézetét, vagy válaszd ki a projektet a Szervezeti analitika nézet Projekt menüjében. Ezután a Szűrők segítségével szűkítsd a használati adatokat API-kulcs és modell szerint, és válassz rövidebb jelentési időszakot.
Hasonlítsd össze a tevékenységet az ugyanarra az időszakra, projektre és API-kulcsra vonatkozó naplókkal. Ellenőrizd, hogy a naplók lefednek-e minden olyan alkalmazást és integrációt, amely ezt a kulcsot használja.
Ha több alkalmazás vagy integráció osztozik ugyanazon a projekten vagy API-kulcson, előfordulhat, hogy az összesített adatból önmagában nem állapítható meg, melyik küldött egy adott kérést. Hasonlítsd össze az irányítópultot az egyes alkalmazások ugyanarra az UTC-időszakra vonatkozó bejegyzéseivel.
Ha továbbra sem tudod megállapítani a használat eredetét, fordulj az OpenAI ügyfélszolgálatához, és add meg az érintett UTC-időszakot, a szervezet- és projektazonosítókat, az API-kulcs azonosítóját, valamint a releváns képernyőképeket vagy naplókat. Ha rendelkezésre állnak, a kérésazonosítókat is add meg. Titkos API-kulcsokat ne adj meg.
Használati adatok exportálása
A használati adatok exportálásához válaszd az Analitika eszköztár CSV exportálása ikonját, majd a Tevékenységi adatok lehetőséget.
Válaszd ki az API-funkciót és egy vagy több dimenziót a Csoportosítás menüben.
Ellenőrizd az API-forrás, Projektek, Felhasználók, API-kulcsok és Modellek beállításait. A Projektek és az API-forrás előzetes kijelölése az Analitika beállításait követi; a többi exportszűrőt a párbeszédpanelen választhatod ki.
Állítsd be a Fájlformátum, Kezdési idő, Befejezési idő és Időköz értékét, majd válaszd a Letöltés lehetőséget. A dátumok teljes UTC-napokat foglalnak magukban.
A tevékenységi és költségadatok az egy naptári évvel ezelőtti nap 00:00 UTC időpontjától a mai napig tekinthetők meg és exportálhatók. Régebbi adatokért fordulj az OpenAI ügyfélszolgálatához. A napi adatok exportálásakor minden fájl 31 napos időszakot fed le.
A havi számlák egyeztetéséről és a tételes exportálásról itt olvashatsz: A havi használat részleteinek exportálása.
Ha a tevékenységi adatok exportja negatív értékű sorokat tartalmaz, az azonos egységű, csoportosítású és dátumú sorokat hasonlítsd össze. A számlázott összegekhez használd a Költségadatok lehetőséget. Egy negatív értékű tevékenységi sor önmagában nem jelenti azt, hogy jóváírás történt a számládon.
Költségek áttekintése
Nyisd meg az Analitika nézetet, és válaszd a Költségek lehetőséget az aktuális projekt költségeinek áttekintéséhez. A teljes szervezet költségeihez válaszd a Szervezeti analitika, majd a Költségek lehetőséget.
Ellenőrizd az aktuális dátumtartományt és a szűrőket, mielőtt összehasonlítod a költségeket a használattal. A Használat és a Költségek eltérő szűrőket kínál; az egyik irányítópulton elérhető szűrő nem feltétlenül alkalmazható a másikon.
Az API-források, API-kulcsok, Modellek és Tételek szűrőkkel szűkítheted a költségadatokat. A szervezeti analitikában a Projekt menüvel választhatod ki az áttekinteni kívánt projekteket. Az elérhető bontásokhoz használd a táblázat Tételek, API-kulcsok, Felhasználók, Projektek és Modellek füleit.
Ha a költési korlát értéke nem érhető el, az nem jelenti azt, hogy a korlát nulla, vagy hogy új korlát lépett életbe. Hozzáférési jogosultságok, be nem állított korlát vagy sikertelen kérés miatt is előfordulhat, hogy az irányítópult nem jelenít meg értéket.
A szolgáltatás állapotának áttekintése
Ha a szervezeted hozzáfér a Szolgáltatás állapota irányítópulthoz, nyisd meg az Analitika nézetben az API teljesítményének áttekintéséhez. A jogosultsági feltételekről és a mutatók meghatározásáról itt olvashatsz: API-hibák és késleltetés hibaelhárítása.
Juttatott kreditek megtekintése
A juttatott kreditek részletei a szervezeted Számlázás oldalán érhetők el.
A juttatott kreditek és az API-használat eltérő információt nyújtanak: az előbbiek a szervezetedhez tartozó krediteket mutatják, míg a használati adatok a szervezet API-tevékenységét.
A Skálázási szint használatának és költségeinek áttekintése
Ha szervezeténél engedélyezve van a Skálázási szint, és rendelkezik a szükséges hozzáféréssel, a részletes használati adatokért nyissa meg a Skálázási szint használati oldalát.
A Skálázási szint csomagjainak költségei a szervezethez, nem pedig az egyes projektekhez vannak rendelve.
A használat nullánál nagyobb, de a projekt költsége nulla
Ellenőrizd, hogy a modell használatát fedezi-e a Skálázási szint kereted. Ha a modell teljes használata a Skálázási szint TPM-keretén belül marad, a projektnél úgy is megjelenhet használat, hogy a modellhez nem tartozik további költség.
A Skálázási szint előfizetési díja továbbra is szervezeti szinten jelenik meg. A teljes szervezet költségeit tekintsd át, ne csupán egyetlen projekt költségeire támaszkodj.
Több szervezet áttekintése
A Használat irányítópult nem összesíti a különböző szervezetek költség- és használati adatait. Minden szervezetet külön kezel, az alszervezeteket is beleértve.
Egy alszervezet megtekintéséhez válaszd ki a szervezetválasztóban.
Ha összesített jelentésekre van szükséged, érdemes külön alszervezetek helyett egy szervezeten belüli projekteket használni, vagy egyéni elemzést készíteni a Használati API segítségével.
Tokenhasználat ellenőrzése egy API-válaszban
A tokenhasználati mezők nevei a végponttól függenek.
| Tokenszám | Csevegés-befejezések | Válaszok |
|---|---|---|
| Bemeneti tokenek | usage.prompt_tokens | usage.input_tokens |
| Kimeneti tokenek | usage.completion_tokens | usage.output_tokens |
| Összes token | usage.total_tokens | usage.total_tokens |
A csevegés-befejezések válaszai tokenhasználati információkat is tartalmazhatnak. Néhány példa:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}A végponttól és a modelltől függően a részletes használati adatok a gyorsítótárazott bemeneti tokenek és az érvelési tokenek számát is tartalmazhatják. Ezek segítenek megérteni, miért nem tükrözi a válasz látható hossza a teljes tokenfelhasználást.
A különböző tokenkategóriák magyarázatát itt találod: A tokenek megértése és számlálása.
Ha egy hangátírási válasz tartalmaz tokenfelhasználási adatokat, az input_tokens értéke már magában foglalja a hang- és szövegbemeneti tokeneket. Ezeket ne add hozzá még egyszer a bemeneti tokenek teljes számához. Az output_tokens értékét külön hasonlítsd össze.
Használati adatok lekérése streamelt Chat Completions-válaszokból
Streamelt Chat Completions-kérés esetén add meg a következőket:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Ha az include_usage engedélyezve van, a data: [DONE] előtt egy további adatblokk tartalmazza a teljes kérés használati adatait. Ennek choices tömbje üres. A többi adatblokkban a usage értéke null.
Ha az adatfolyam megszakad, előfordulhat, hogy nem kapod meg ezt az utolsó, használati adatokat tartalmazó adatblokkot. Az utolsó adatblokk hiánya nem bizonyítja, hogy a kérés nem használt fel tokeneket.
Ez a beállítás csak a Chat Completions esetében használható. A részleteket lásd itt: A csevegés-befejezési API referenciadokumentációja.
