Ez az oldal gépi fordítással készült. Tekintsd meg az eredeti angol nyelvű cikket.

Az API-használat és a költségek áttekintése

Tekintsd át az API-tevékenységet az Analitikában és a tokenszámokat az API-válaszokban. Ismerd meg a projektszűrőket, az exportálást és a Skálázási szint költségeit.

Frissítve: 2 days ago

Á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

  1. 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.

  2. 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.

  3. 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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  1. Válaszd ki az API-funkciót és egy vagy több dimenziót a Csoportosítás menüben.

  2. 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.

  3. Á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ámCsevegés-befejezésekVálaszok
Bemeneti tokenekusage.prompt_tokensusage.input_tokens
Kimeneti tokenekusage.completion_tokensusage.output_tokens
Összes tokenusage.total_tokensusage.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.

Hasznos volt ez a cikk?