Den här sidan har maskinöversatts. Visa den ursprungliga engelska artikeln.

Granska API-användning och kostnader

Granska API-aktivitet i Analys, kontrollera antalet token i API-svar och förstå projektfilter, exporter och kostnader för skalningsnivån.

Uppdaterades: 3 days ago

Översikt

Du kan granska API-användningen på två sätt:

  • Använd Analys > Användning för att granska API-aktivitet under aktuella och tidigare rapporteringsperioder.

  • Läs användningsinformationen i ett API-svar för att kontrollera en enskild begäran.

Playground använder samma API-anrop som dina program. Dess token räknas in i kontots API-användning och omfattas av samma användningsregler och priser.

Åtkomst till kontrollpanelen

Du måste vara organisationsägare eller ha behörigheten Användningspanel för att få åtkomst till användningspanelen.

Granska användning i instrumentpanelen

Öppna Analys i API-plattformen och välj Användning för att granska det aktuella projektet. För rapportering för hela organisationen väljer du Organisationsanalys. Välj den rapporteringsperiod du vill granska och kontrollera den igen när du har växlat mellan projekt- och organisationsanalys.

Data i instrumentpanelen visas i UTC. Tänk på tidszonen när du jämför aktiviteten i instrumentpanelen med dina programloggar.

Det kan ta tid innan den senaste användningen visas i instrumentpanelen. Om den senaste aktiviteten saknas kan du kontrollera igen senare.

Filtrera användning

I projektets Analys är användningen avgränsad till det valda projektet. I Organisationsanalys använder du Projekt för att välja de projekt du vill granska. Alla projekt omfattar samtliga projekt i organisationen, med hänsyn till eventuella andra filter som du har valt.

Använd Filter för att avgränsa användningen efter API-källor, API-nycklar, Modeller, Användare eller Bearbetningsnivå. Under API-källor kan du välja Alla API-källor, Agents API eller Direkt API.

Ta bort enskilda val eller välj Rensa filter för att återställa panelen Filter. När du rensar filtren växlar du inte mellan projekt- och organisationsanalys.

Använd Filter i diagrammet Användning för att filtrera efter Batch. Välj Återställ diagramfilter för att återställa filtren för det diagrammet.

Om en funktion inte stöder de valda filtren kan dess värden vara otillgängliga. Otillgängliga värden betyder inte att användningen är noll.

Om ett filter visar ett behörighetsfel kanske du inte har åtkomst till dess alternativ. Det betyder inte att ingen användning har registrerats.

Granska en enskild användares användning

  1. Öppna Användning i vyn Analys för det projekt eller den organisation du vill granska. I tabellen API-funktioner väljer du Visa för Svar och slutförda chattar.

  2. Under Filter väljer du Användare och sedan användaren. Resultaten uppdateras direkt.

  3. Granska diagrammet och tabellen för den användaren.

För att granska en användares användning av olika funktioner tillämpar du filtret Användare i översikten Användning. För att jämföra användare rensar du det filtret och väljer tabellfliken Användare.

Visa token per dag, timme eller minut

Där intervallval finns i Användning väljer du 1d eller 1h för att visa token per dag eller timme, eller 1m för att undersöka token per minut (TPM). Välj Automatiskt för att låta instrumentpanelen välja tidsintervall för rapporteringsperioden. Dessa intervall gäller användningsdata, inte faktureringsdata.

Om 1m är inaktiverat väljer du en kortare rapporteringsperiod eller använder Markera för att zooma och drar över diagrammet för att begränsa intervallet. Välj sedan 1m. Tryck på Esc för att avbryta en zoommarkering. Välj det aktuella datumintervallet i verktygsfältet i Analys för att välja en annan rapporteringsperiod.

Granska diagram och tabeller över användning

Använd Mätvärden för att välja en eller flera serier som ska visas tillsammans, till exempel Indatatoken, Ej cachade indatatoken, Cachade indatatoken, Indatatoken som skrivs till cache, Ljudtoken för indata, Utdatatoken och Ljudtoken för utdata. Vilka mätvärden som är tillgängliga beror på funktionen. Använd teckenförklaringen för att identifiera varje serie.

Använd Gruppera efter för att ordna användningen efter kategorier som Projekt, Användare eller Modell, där dessa är tillgängliga. Filtren styr vilken användning som tas med. Grupperingen styr hur den visas. Växla mellan linje- och stapeldiagram för att undersöka trender eller jämföra kategorier.

Använd tabellflikarna under Användning för att granska de tillgängliga uppdelningarna. Tabellerna visar relevanta mått för varje rad, till exempel begäranden, indata- och utdatatoken eller funktionsspecifika enheter.

Under API-funktioner väljer du Visa för en funktion för att öppna dess detaljerade diagram och uppdelningar. Svar och slutförda chattar innehåller separata diagram för Token och Begäranden samt mätvärdet Modellbegäranden. Flikarna för uppdelning använder samma dimensioner som översikten, men saknar fliken API-funktioner. Använd Användning i navigeringsstigen för att återgå till översikten.

När du har valt ett alternativ under Gruppera efter kan diagrammet slå ihop ytterligare kategorier under Övrigt. Om Övrigt visas i diagrammets teckenförklaring väljer du den etiketten för att se vilka kategorier som ingår och deras användningsvärden.

Välj Jämför instrumentpaneler för att visa Användning bredvid en annan instrumentpanel för samma rapporteringsperiod. Använd Vänster instrumentpanel och Höger instrumentpanel för att välja vyer. Om det valda tidsintervallet inte är tillgängligt för de två instrumentpanelerna växlar vyn till Automatiskt. Välj Avsluta jämförelse för att återgå till instrumentpanelen.

Undersök användning som du inte känner igen

Om Användning visar aktivitet som du inte kan matcha med begäranden i dina programloggar gör du följande kontroller:

  1. Kontrollera organisationen, vilka projekt som ingår och rapporteringsperioden. Använd UTC när du jämför instrumentpanelens tidsstämplar med dina programloggar.

  2. Använd projektvyn för det berörda projektet eller välj det under Projekt i Organisationsanalys. Använd sedan Filter för att avgränsa användningen efter API-nyckel och modell och välj en kortare rapporteringsperiod.

  3. Jämför aktiviteten med loggar för samma period, projekt och API-nyckel. Kontrollera om dina loggar omfattar alla program eller integrationer som använder den nyckeln.

  4. Om flera program eller integrationer delar samma projekt eller API-nyckel räcker totalsumman kanske inte för att identifiera vilket program eller vilken integration som skickade en begäran. Jämför instrumentpanelen med loggar från varje program för samma UTC-period.

  5. Om du fortfarande inte kan förklara användningen ska du kontakta OpenAI-supporten och ange den berörda UTC-perioden, organisations- och projekt-ID:n, API-nyckelns identifierare samt relevanta skärmbilder eller loggar. Bifoga ID:n för begäranden om de finns tillgängliga. Ta inte med hemliga API-nycklar.

Exportera användningsdata

För att exportera användning väljer du ikonen Exportera CSV i verktygsfältet i Analys och sedan Aktivitetsdata.

  1. Välj API-funktion och en eller flera dimensioner under Gruppera efter.

  2. Kontrollera API-källa, Projekt, Användare, API-nycklar och Modeller. Projekt och API-källa är förvalda utifrån Analys. Välj övriga exportfilter i dialogrutan.

  3. Välj Filformat, Starttid, Sluttid och Tidsintervall och välj sedan Ladda ned. Datumen omfattar hela UTC-dygn.

Aktivitets- och kostnadsdata kan visas och exporteras från kl. 00.00 UTC för ett kalenderår sedan till och med i dag. För äldre data, kontakta OpenAI-supporten. Dagliga data exporteras i filer som omfattar perioder om 31 dagar.

För avstämning av månadsfakturor och export av fakturarader, se: Exportera månatliga användningsuppgifter.

Om en export av aktivitetsdata innehåller rader med negativa värden ska du jämföra rader med samma enhet, gruppering och datum. Använd Kostnadsdata för fakturerade belopp. En aktivitetsrad med ett negativt värde innebär inte i sig att din faktura har krediterats.

Granska kostnader

Öppna Analys och välj Kostnader för att granska kostnaderna för det aktuella projektet. För kostnader för hela organisationen väljer du Organisationsanalys och sedan Kostnader.

Kontrollera det aktuella datumintervallet och filtren innan du jämför kostnader med användning. Användning och Kostnader har olika filter. Ett filter som finns i den ena instrumentpanelen kanske inte gäller i den andra.

Använd API-källor, API-nycklar, Modeller och Fakturarader för att avgränsa kostnaderna. I organisationsanalysen använder du Projekt för att inkludera de projekt du vill granska. Använd tabellflikarna Fakturarader, API-nycklar, Användare, Projekt och Modeller för att se de tillgängliga uppdelningarna.

Om värdet för kostnadsgränsen är otillgängligt betyder det inte att gränsen är noll eller att en ny gräns har tillämpats. Åtkomstbehörigheter, en gräns som inte har angetts eller en misslyckad begäran kan hindra instrumentpanelen från att visa ett värde.

Granska tjänstens status

Om din organisation har tillgång till Tjänststatus öppnar du den instrumentpanelen i Analys för att granska API-prestanda. För åtkomstkrav och definitioner av mätvärden, se: Felsöka API-fel och latens.

Visa tilldelade krediter

Information om tilldelade krediter finns på organisationens faktureringssida.

Tilldelade krediter och API-användning besvarar olika frågor: tilldelade krediter visar de krediter som är kopplade till organisationen, medan användningen visar dess API-aktivitet.

Granska användning och kostnader för Skalningsnivå

Om Skalningsnivå är aktiverad för organisationen och du har nödvändig behörighet kan du öppna användningssidan för Skalningsnivå för detaljerad användningsinformation.

Kostnader för paket på Skalningsnivå tillskrivs organisationen, inte enskilda projekt.

Användningen är större än noll, men projektkostnaden är noll

Kontrollera om modellens användning täcks av din tilldelning för skalningsnivån. Om all användning av modellen ryms inom TPM-tilldelningen för skalningsnivån kan projektet visa användning utan ytterligare modellkostnader.

Abonnemangskostnaden för skalningsnivån ligger kvar på organisationsnivå. Granska kostnaderna för hela organisationen i stället för att enbart utgå från ett enskilt projekts kostnader.

Granska flera organisationer

Instrumentpanelen för användning sammanställer inte kostnads- eller användningsdata från flera organisationer. Varje organisation, även en underorganisation, behandlas separat.

För att visa en underorganisation väljer du den i organisationsväljaren.

Om du behöver samlad rapportering kan du överväga att använda projekt inom en organisation i stället för separata underorganisationer, eller använda API:et för användning för anpassad analys.

Kontrollera tokenanvändning i ett API-svar

Fältnamnen för tokenanvändning beror på slutpunkten.

Antal tokenSlutförda chattarSvar
Indatatokenusage.prompt_tokensusage.input_tokens
Utdatatokenusage.completion_tokensusage.output_tokens
Totalt antal tokenusage.total_tokensusage.total_tokens

Svar från slutförda chattar kan innehålla information om tokenanvändning. Exempel:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

Beroende på slutpunkt och modell kan användningsuppgifterna även innehålla antal cachade indatatoken och resonemangstoken. Dessa uppgifter hjälper till att förklara varför den synliga längden på ett svar inte visar dess totala tokenanvändning.

För en förklaring av de olika tokenkategorierna, se: Förstå och räkna token.

I ett transkriptionssvar som redovisar tokenanvändning ingår indatatoken för ljud och text redan i input_tokens. Lägg inte till dessa delar i det totala antalet indatatoken igen. Jämför output_tokens separat.

Hämta användningsdata från strömmade Chat Completions

Inkludera följande i en begäran om strömmade Chat Completions:

{
"stream": true,
"stream_options": {
"include_usage": true
}
}

När include_usage är aktiverat innehåller ett extra datablock före data: [DONE] användningsdata för hela begäran. Dess choices-array är tom. I övriga datablock är värdet för usage null.

Om strömmen avbryts kanske du inte får det sista datablocket med användningsdata. Att det sista datablocket saknas bevisar inte att begäran inte använde några token.

Den här konfigurationen gäller endast Chat Completions. Mer information finns i referensen för API för slutförda chattar.

Var den här artikeln till hjälp?