Denne siden ble maskinoversatt. Se den opprinnelige engelske artikkelen.

Se gjennom API-bruk og kostnader

Se API-aktivitet i Analyse, sjekk antall token i API-svar, og forstå prosjektfiltre, eksporter og kostnader for Skaleringsnivå.

Oppdatert: 7 days ago

Oversikt

Du kan se gjennom API-bruk på to måter:

  • Bruk Analyse > Bruk for å se API-aktivitet i gjeldende og tidligere rapporteringsperioder.

  • Les bruksinformasjonen i et API-svar for å kontrollere en enkelt forespørsel.

Playground bruker de samme API-kallene som applikasjonene dine. Token som brukes der, telles med i kontoens API-bruk og følger de samme bruksreglene og prisene.

Tilgang til oversikten

Du må være organisasjonseier eller ha tillatelsen Bruksoversikt for å få tilgang til bruksoversikten.

Se gjennom bruken i dashbordet

Åpne Analyse i API-plattformen og velg Bruk for å se gjennom det gjeldende prosjektet. For rapporter som dekker hele organisasjonen, velger du Organisasjonsanalyse. Velg rapporteringsperioden du vil se gjennom, og kontroller den på nytt etter at du har byttet mellom prosjekt- og organisasjonsanalyse.

Data i dashbordet vises i UTC. Husk denne tidssonen når du sammenligner aktiviteten i dashbordet med applikasjonsloggene dine.

Det kan ta litt tid før nylig bruk vises i dashbordet. Hvis nylig aktivitet mangler, sjekk igjen senere.

Filtrer bruksdata

I prosjektets Analyse-visning er bruken avgrenset til det valgte prosjektet. I Organisasjonsanalyse bruker du Prosjekt til å velge prosjektene du vil se gjennom. Alle prosjekter omfatter alle prosjektene i organisasjonen, med forbehold om eventuelle andre filtre du har valgt.

Bruk Filtre til å avgrense bruken etter API-kilder, API-nøkler, Modeller, Brukere eller Behandlingsnivå. Under API-kilder kan du velge Alle API-kilder, Agents API eller Direkte API.

Fjern enkeltvalg eller velg Fjern filtre for å tilbakestille Filtre-panelet. Når du fjerner filtre, bytter du ikke mellom prosjekt- og organisasjonsanalyse.

Bruk Filter i Bruk-diagrammet for å filtrere etter Satsvis behandling. Velg Tilbakestill diagramfiltre for å tilbakestille filtrene i det aktuelle diagrammet.

Hvis en funksjon ikke støtter de valgte filtrene, kan verdiene for den være utilgjengelige. Utilgjengelige verdier betyr ikke at bruken er null.

Hvis et filter viser en tilgangsfeil, har du kanskje ikke tilgang til alternativene i det. Dette betyr ikke at ingen bruk ble registrert.

Se gjennom bruken til en enkelt bruker

  1. Åpne Bruk i Analyse-visningen for prosjektet eller organisasjonen du vil se gjennom. I tabellen API-funksjoner velger du Vis for Responses og Chat Completions.

  2. Under Filtre velger du Brukere og deretter den aktuelle brukeren. Resultatene oppdateres umiddelbart.

  3. Se gjennom diagrammet og tabellen for den aktuelle brukeren.

For å se en brukers aktivitet på tvers av funksjoner bruker du filteret Brukere i Bruk-oversikten. For å sammenligne brukere fjerner du dette filteret og velger tabellfanen Brukere.

Se token per dag, time eller minutt

Der intervallvalg er tilgjengelige i Bruk, velger du 1d eller 1t for å se token per dag eller time, eller 1m for å undersøke token per minutt (TPM). Velg Automatisk for å la dashbordet velge tidsintervallet for rapporteringsperioden din. Disse intervallene gjelder bruksdata, ikke faktureringsdata.

Hvis 1m er deaktivert, velger du en kortere rapporteringsperiode eller bruker Marker for å zoome og drar over diagrammet for å avgrense perioden. Velg deretter 1m. Trykk på Esc for å avbryte en zoommarkering. Velg det gjeldende datointervallet på verktøylinjen i Analyse for å velge en annen rapporteringsperiode.

Se gjennom bruksdiagrammer og -tabeller

Bruk Måleverdier til å velge én eller flere dataserier som skal vises sammen, blant annet Inndatatoken, Ikke-bufrede inndatatoken, Bufrede inndatatoken, Inndatatoken skrevet til hurtigbuffer, Lydtoken inn, Utdatatoken og Lydtoken ut. Hvilke måleverdier som er tilgjengelige, avhenger av funksjonen. Bruk tegnforklaringen til å identifisere hver dataserie.

Bruk Grupper etter til å organisere bruken etter kategorier som Prosjekt, Bruker eller Modell, der disse er tilgjengelige. Filtre bestemmer hvilken bruk som tas med. Grupperingen bestemmer hvordan den vises. Bytt mellom linje- og stolpediagrammer for å undersøke trender eller sammenligne kategorier.

Bruk fanene i Bruk-tabellen til å se de tilgjengelige fordelingene. Tabellene viser relevante måleverdier for hver rad, for eksempel forespørsler, inndata- og utdatatoken eller funksjonsspesifikke enheter.

Under API-funksjoner velger du Vis for en funksjon for å åpne detaljerte diagrammer og fordelinger for den. Responses og Chat Completions har separate diagrammer for Token og Forespørsler, samt måleverdien Modellforespørsler. Fordelingsfanene bruker de samme dimensjonene som oversikten, men har ikke fanen API-funksjoner. Bruk Bruk i navigasjonsstien for å gå tilbake til oversikten.

Når du har valgt et alternativ under Grupper etter, kan diagrammet samle flere kategorier under Annet. Hvis Annet vises i tegnforklaringen, velger du etiketten for å se kategoriene som er inkludert, og bruksverdiene deres.

Velg Sammenlign dashbord for å vise Bruk ved siden av et annet dashbord for samme rapporteringsperiode. Bruk Venstre dashbord og Høyre dashbord til å velge visningene. Hvis det valgte tidsintervallet ikke er tilgjengelig for de to dashbordene, bytter visningen til Automatisk. Velg Avslutt sammenligning for å gå tilbake til dashbordet.

Undersøk bruk du ikke kjenner igjen

Hvis Bruk viser aktivitet du ikke kan knytte til forespørsler i applikasjonsloggene dine, kan du sjekke følgende:

  1. Kontroller organisasjonen, hvilke prosjekter som er inkludert, og rapporteringsperioden. Bruk UTC når du sammenligner tidsstempler i dashbordet med applikasjonsloggene dine.

  2. Bruk prosjektvisningen for det aktuelle prosjektet, eller velg det under Prosjekt i Organisasjonsanalyse. Bruk deretter Filtre til å avgrense bruken etter API-nøkkel og modell, og velg en kortere rapporteringsperiode.

  3. Sammenlign aktiviteten med logger for samme periode, prosjekt og API-nøkkel. Sjekk om loggene dekker alle applikasjoner eller integrasjoner som bruker denne nøkkelen.

  4. Hvis flere applikasjoner eller integrasjoner deler samme prosjekt eller API-nøkkel, er ikke totalen alene nødvendigvis nok til å identifisere hvilken som sendte en forespørsel. Sammenlign dashbordet med loggdata fra hver applikasjon for samme UTC-periode.

  5. Hvis du fortsatt ikke kan forklare bruken, kontakt OpenAIs kundestøtte og oppgi den aktuelle UTC-perioden, organisasjons- og prosjekt-ID-er, API-nøkkelens identifikator og relevante skjermbilder eller logger. Ta med forespørsels-ID-er hvis de er tilgjengelige. Ikke ta med hemmelige API-nøkler.

Eksporter bruksdata

For å eksportere bruksdata velger du ikonet Eksporter CSV på verktøylinjen i Analyse, og deretter Aktivitetsdata.

  1. Velg API-funksjon og én eller flere dimensjoner under Grupper etter.

  2. Kontroller API-kilde, Prosjekter, Brukere, API-nøkler og Modeller. Prosjekter og API-kilde er forhåndsvalgt fra Analyse. Velg de andre eksportfiltrene i dialogboksen.

  3. Velg Filformat, Starttid, Sluttid og Tidsintervall, og velg deretter Last ned. Datoene omfatter hele UTC-døgn.

Aktivitets- og kostnadsdata kan vises og eksporteres fra kl. 00.00 UTC for ett kalenderår siden til og med i dag. For eldre data, kontakt OpenAIs kundestøtte. Daglige data eksporteres i filer som dekker perioder på 31 dager.

For månedlig fakturaavstemming og eksport av fakturalinjer, se: Eksportere månedlige bruksdetaljer.

Hvis en eksport av aktivitetsdata inneholder negative rader, sammenligner du rader med samme enhet, gruppering og datoer. Bruk Kostnadsdata for fakturerte beløp. En negativ aktivitetsrad er i seg selv ikke en bekreftelse på at fakturaen din er kreditert.

Se gjennom kostnader

Åpne Analyse og velg Kostnader for å se kostnadene for det gjeldende prosjektet. For kostnader for hele organisasjonen velger du Organisasjonsanalyse og deretter Kostnader.

Kontroller det gjeldende datointervallet og filtrene før du sammenligner kostnader med bruk. Bruk og Kostnader har ulike filtre. Et filter som er tilgjengelig i det ene dashbordet, gjelder ikke nødvendigvis i det andre.

Bruk API-kilder, API-nøkler, Modeller og Fakturalinjer til å avgrense kostnadene. I organisasjonsanalysen bruker du Prosjekt til å inkludere prosjektene du vil se gjennom. Bruk tabellfanene Fakturalinjer, API-nøkler, Brukere, Prosjekter og Modeller for å se de tilgjengelige fordelingene.

At verdien for kostnadsgrensen er utilgjengelig, betyr ikke at grensen din er null eller at en ny grense er tatt i bruk. Tilgangsrettigheter, en grense som ikke er angitt, eller en mislykket forespørsel kan hindre dashbordet i å vise en verdi.

Se gjennom tjenestestatus

Hvis organisasjonen din har tilgang til Tjenestestatus, åpner du dette dashbordet i Analyse for å se gjennom API-ytelsen. For tilgangskrav og definisjoner av måleverdier, se: Feilsøking av API-feil og ventetid.

Se tildelte kreditter

Du finner detaljer om tildelte kreditter på organisasjonens faktureringsside.

Tildelte kreditter og API-bruk gir ulik informasjon: Tildelte kreditter viser kredittene som er knyttet til organisasjonen din, mens bruk viser API-aktiviteten dens.

Se gjennom bruk og kostnader for Skaleringsnivå

Hvis organisasjonen har aktivert Skaleringsnivå og du har nødvendig tilgang, åpner du brukssiden for Skaleringsnivå for å se detaljert bruk.

Kostnadene for Skaleringsnivå-pakker tilordnes organisasjonen, ikke enkeltprosjekter.

Bruken er større enn null, men prosjektkostnadene er null

Sjekk om modellbruken dekkes av kvoten din på Skaleringsnivå. Hvis all bruk av modellen er innenfor TPM-kvoten på Skaleringsnivå, kan prosjektet vise bruk uten ekstra modellkostnader.

Abonnementskostnaden for Skaleringsnivå ligger fortsatt på organisasjonsnivå. Se på kostnadene for hele organisasjonen i stedet for å basere deg på kostnadene for ett enkelt prosjekt.

Se gjennom flere organisasjoner

Bruksdashbordet slår ikke sammen kostnads- eller bruksdata på tvers av organisasjoner. Hver organisasjon, også en underorganisasjon, behandles separat.

For å se en underorganisasjon velger du den i organisasjonsvelgeren.

Hvis du trenger samlet rapportering, kan du vurdere å bruke prosjekter innenfor én organisasjon i stedet for separate underorganisasjoner, eller bruke Usage API til egendefinerte analyser.

Sjekk tokenbruk i et API-svar

Feltnavnene for tokenbruk avhenger av endepunktet.

Antall tokenChat CompletionsResponses
Inndatatokenusage.prompt_tokensusage.input_tokens
Utdatatokenusage.completion_tokensusage.output_tokens
Totalt antall tokenusage.total_tokensusage.total_tokens

Svar fra Chat Completions kan inneholde informasjon om tokenbruk. Eksempler:

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

Avhengig av endepunkt og modell kan bruksdetaljene også inkludere antall bufrede inndata-token og resonneringstoken. Disse tallene bidrar til å forklare hvorfor den synlige lengden på et svar ikke gjenspeiler hele tokenforbruket.

For en forklaring av de ulike tokenkategoriene, se: Forstå og telle token.

I et transkripsjonssvar som rapporterer tokenforbruk, er inndata-token for lyd og tekst allerede inkludert i input_tokens. Ikke legg disse delmengdene til det totale antallet inndata-token på nytt. Sammenlign output_tokens separat.

Hent bruksdata fra strømmede Chat Completions-svar

For en Chat Completions-forespørsel med strømming inkluderer du:

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

Når include_usage er aktivert, inneholder en ekstra datablokk før data: [DONE] bruksdata for hele forespørselen. Datablokkens choices-array er tom. Andre datablokker har verdien null i usage-feltet.

Hvis strømmen avbrytes, kan det hende du ikke mottar den siste datablokken med bruksdata. At den siste datablokken mangler, betyr ikke at forespørselen ikke brukte noen token.

Denne konfigurasjonen gjelder bare for Chat Completions. Du finner mer informasjon i referansedokumentasjonen for Chat Completions API (API for samtalesvar).

Var denne artikkelen nyttig?