Visão geral
Pode consultar a utilização da API de duas formas:
Use Análise de dados > Utilização para consultar a atividade da API no período de relatório atual e em períodos anteriores.
Leia as informações de utilização numa resposta da API para verificar um pedido específico.
O Playground usa as mesmas chamadas à API que as suas aplicações. Os respetivos tokens contam para a utilização da API da sua conta e estão sujeitos às mesmas regras de utilização e aos mesmos preços.
Acesso ao painel
Para aceder ao Painel de utilização, tem de ser proprietário da organização ou ter a permissão Painel de utilização.
Consultar a utilização no painel
Na Plataforma de API, abra Análise de dados e selecione Utilização para consultar o projeto atual. Para obter relatórios de toda a organização, selecione Análise de dados da organização. Selecione o período de relatório que pretende consultar e volte a verificá-lo depois de alternar entre a análise de dados do projeto e a da organização.
Os dados do painel são apresentados em UTC. Tenha esse fuso horário em conta ao comparar a atividade do painel com os registos da sua aplicação.
A utilização recente pode demorar a aparecer no painel. Se a atividade recente não aparecer, volte a verificar mais tarde.
Filtrar a utilização
Em Análise de dados do projeto, a utilização limita-se ao projeto selecionado. Em Análise de dados da organização, use Projeto para selecionar os projetos que pretende consultar. Todos os projetos inclui todos os projetos da organização, tendo em conta os restantes filtros selecionados.
Use Filtros para restringir a utilização por Origens da API, Chaves de API, Modelos, Utilizadores ou Nível de processamento. Origens da API permite selecionar Todas as origens da API, Agents API ou API direta.
Remova seleções individuais ou selecione Limpar filtros para repor o painel Filtros. Limpar os filtros não alterna entre a análise de dados do projeto e a da organização.
Use Filtrar no gráfico de Utilização para filtrar por Lote. Selecione Repor filtros do gráfico para repor os filtros desse gráfico.
Se uma funcionalidade não suportar os filtros selecionados, os respetivos valores podem não estar disponíveis. Valores indisponíveis não significam utilização nula.
Se um filtro apresentar um erro de permissão, poderá não ter acesso às respetivas opções. Isto não significa que não tenha sido registada qualquer utilização.
Consultar a utilização de um utilizador específico
Abra Utilização na vista de Análise de dados do projeto ou da organização que pretende consultar. Na tabela Funcionalidades da API, selecione Ver junto a Responses e Chat Completions.
Em Filtros, selecione Utilizadores e escolha o utilizador. Os resultados são atualizados imediatamente.
Consulte o gráfico e a tabela desse utilizador.
Para consultar a utilização de um utilizador nas várias funcionalidades, aplique o filtro Utilizadores na vista geral de Utilização. Para comparar utilizadores, limpe esse filtro e selecione o separador Utilizadores da tabela.
Ver tokens por dia, hora ou minuto
Quando os controlos de intervalo estiverem disponíveis em Utilização, selecione 1d ou 1h para ver os tokens por dia ou hora, ou 1m para analisar os tokens por minuto (TPM). Selecione Automático para que o painel escolha o intervalo de tempo para o seu período de relatório. Estes intervalos aplicam-se aos dados de utilização, não aos dados de faturação.
Se 1m estiver desativado, selecione um período de relatório mais curto ou use Selecionar para ampliar e arraste sobre o gráfico para restringir o intervalo. Em seguida, selecione 1m. Prima Esc para cancelar uma seleção de ampliação. Selecione o intervalo de datas atual na barra de ferramentas de Análise de dados para escolher outro período de relatório.
Consultar gráficos e tabelas de utilização
Use Métricas para selecionar uma ou mais séries a apresentar em conjunto, incluindo Tokens de entrada, Tokens de entrada fora da cache, Tokens de entrada em cache, Tokens de entrada para escrita na cache, Tokens de áudio de entrada, Tokens de saída e Tokens de áudio de saída. As métricas disponíveis dependem da funcionalidade. Use a legenda para identificar cada série.
Use Agrupar por para organizar a utilização por categorias como Projeto, Utilizador ou Modelo, quando disponíveis. Os filtros determinam que utilização é incluída; o agrupamento determina como é apresentada. Alterne entre gráficos de linhas e de barras para analisar tendências ou comparar categorias.
Use os separadores da tabela Utilização para consultar as discriminações disponíveis. As tabelas apresentam as medidas relevantes para cada linha, como pedidos, tokens de entrada e de saída ou unidades específicas da funcionalidade.
Em Funcionalidades da API, selecione Ver junto a uma funcionalidade para abrir os respetivos gráficos detalhados e discriminações. Responses e Chat Completions inclui gráficos separados de Tokens e Pedidos, bem como a métrica Pedidos ao modelo. Os respetivos separadores de discriminação usam as mesmas dimensões que a vista geral, sem o separador Funcionalidades da API. Use Utilização no trilho de navegação para regressar à vista geral.
Depois de selecionar uma opção em Agrupar por, o gráfico pode reunir categorias adicionais em Outros. Se Outros aparecer na legenda do gráfico, selecione essa etiqueta para ver as categorias incluídas e os respetivos valores de utilização.
Selecione Comparar painéis para ver Utilização ao lado de outro painel relativo ao mesmo período de relatório. Use Painel esquerdo e Painel direito para selecionar as vistas. Se o intervalo de tempo selecionado não estiver disponível para o par de painéis, a vista muda para Automático. Selecione Sair da comparação para regressar ao painel.
Investigar utilização que não reconhece
Se Utilização apresentar atividade que não consegue associar a pedidos nos registos da sua aplicação, faça as seguintes verificações:
Confirme a organização, o âmbito dos projetos e o período de relatório. Use UTC ao comparar as datas e horas do painel com os registos da sua aplicação.
Use a vista do projeto afetado ou selecione-o em Projeto, em Análise de dados da organização. Em seguida, use Filtros para restringir a utilização por chave de API e modelo e selecione um período de relatório mais curto.
Compare a atividade com os registos relativos ao mesmo período, projeto e chave de API. Verifique se os seus registos abrangem todas as aplicações ou integrações que usam essa chave.
Se várias aplicações ou integrações partilharem o mesmo projeto ou chave de API, o total, por si só, pode não permitir identificar qual delas enviou um pedido. Compare o painel com os registos de cada aplicação para o mesmo período em UTC.
Se continuar sem conseguir explicar a utilização, contacte o Apoio da OpenAI e indique o período afetado em UTC, os IDs da organização e do projeto, o identificador da chave de API e as capturas de ecrã ou os registos relevantes. Inclua os IDs dos pedidos, se estiverem disponíveis. Não inclua chaves de API secretas.
Exportar dados de utilização
Para exportar a utilização, selecione o ícone Exportar CSV na barra de ferramentas de Análise de dados e, em seguida, selecione Dados de atividade.
Selecione a Funcionalidade da API e uma ou mais dimensões em Agrupar por.
Verifique Origem da API, Projetos, Utilizadores, Chaves de API e Modelos. Projetos e Origem da API são pré-selecionados com base em Análise de dados; selecione os restantes filtros de exportação na caixa de diálogo.
Selecione Formato do ficheiro, Hora de início, Hora de fim e Intervalo de tempo e, em seguida, selecione Transferir. As datas incluem dias completos em UTC.
Pode consultar e exportar dados de atividade e de custos desde as 00:00 UTC da data correspondente a há um ano até hoje. Para obter dados mais antigos, contacte o Apoio da OpenAI. Os dados diários são exportados em ficheiros que abrangem períodos de 31 dias.
Para saber mais sobre a reconciliação de faturas mensais e a exportação de rubricas, consulte: Exportar detalhes de utilização mensal.
Se uma exportação de atividade incluir linhas com valores negativos, compare as linhas com a mesma unidade, agrupamento e datas. Use Dados de custos para consultar os montantes faturados. Uma linha de atividade com valor negativo não comprova, por si só, que foi aplicado um crédito à sua fatura.
Consultar despesas
Abra Análise de dados e selecione Despesas para consultar os custos do projeto atual. Para consultar os custos de toda a organização, selecione Análise de dados da organização e, em seguida, Despesas.
Verifique o intervalo de datas atual e os filtros antes de comparar os custos com a utilização. Utilização e Despesas oferecem filtros diferentes; um filtro disponível num dos painéis pode não se aplicar ao outro.
Use Origens da API, Chaves de API, Modelos e Rubricas para restringir as despesas apresentadas. Na análise de dados da organização, use Projeto para incluir os projetos que pretende consultar. Use os separadores Rubricas, Chaves de API, Utilizadores, Projetos e Modelos da tabela para consultar as discriminações disponíveis.
Se o valor do limite de despesas estiver indisponível, isso não significa que o limite seja zero ou que tenha sido aplicado um novo limite. As permissões de acesso, a ausência de um limite definido ou uma falha num pedido podem impedir o painel de apresentar um valor.
Consultar o estado do serviço
Se a sua organização tiver acesso a Estado do serviço, abra esse painel em Análise de dados para consultar o desempenho da API. Para saber mais sobre a elegibilidade e as definições das métricas, consulte: Resolver problemas de erros e latência da API.
Ver créditos atribuídos
Os detalhes dos créditos atribuídos estão disponíveis na página de Faturação da sua organização.
Os créditos atribuídos e a utilização da API respondem a perguntas diferentes: os primeiros mostram os créditos associados à sua organização, enquanto a utilização mostra a respetiva atividade na API.
Analisar a utilização e os custos da Camada de escala
Se a sua organização tiver a Camada de escala ativada e dispuser do acesso necessário, abra a página de utilização da Camada de escala para ver dados detalhados.
Os custos dos pacotes da Camada de escala são atribuídos à organização e não a projetos individuais.
A utilização é superior a zero, mas as despesas do projeto são nulas
Verifique se a utilização do modelo está abrangida pela capacidade que lhe foi atribuída na Camada de escala. Se toda a utilização desse modelo estiver dentro da capacidade de TPM atribuída na Camada de escala, o projeto pode apresentar utilização sem despesas adicionais com o modelo.
O custo da subscrição da Camada de escala continua a ser contabilizado ao nível da organização. Consulte as despesas de toda a organização em vez de se basear nas despesas de um único projeto.
Consultar várias organizações
O painel de Utilização não combina dados de custos ou de utilização de várias organizações. Cada organização, incluindo as suborganizações, é tratada separadamente.
Para ver uma suborganização, selecione-a no seletor de organizações.
Se precisar de relatórios combinados, considere usar projetos dentro de uma única organização em vez de suborganizações separadas, ou use a API de utilização para fazer análises personalizadas.
Verificar a utilização de tokens numa resposta da API
Os nomes dos campos de utilização de tokens dependem do endpoint.
| Contagem de tokens | Chat Completions | Responses |
|---|---|---|
| Tokens de entrada | usage.prompt_tokens | usage.input_tokens |
| Tokens de saída | usage.completion_tokens | usage.output_tokens |
| Total de tokens | usage.total_tokens | usage.total_tokens |
As respostas de Chat Completions podem incluir informações sobre a utilização de tokens. Alguns exemplos:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Dependendo do endpoint e do modelo, os detalhes de utilização também podem incluir contagens de tokens de entrada em cache e de tokens de raciocínio. Estas contagens ajudam a explicar por que motivo a extensão visível de uma resposta não reflete a utilização total de tokens.
Para obter uma explicação das diferentes categorias de tokens, consulte: Compreender e contar tokens.
Numa resposta de transcrição que indique a utilização de tokens, os tokens de entrada de áudio e texto já estão incluídos em input_tokens. Não volte a somar esses componentes ao total de entrada. Compare output_tokens separadamente.
Obter dados de utilização de Chat Completions em streaming
Num pedido de Chat Completions em streaming, inclua:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Com include_usage ativado, um bloco adicional antes de data: [DONE] contém os dados de utilização de todo o pedido. O respetivo array choices está vazio. Nos restantes blocos, o campo usage tem o valor null.
Se o streaming for interrompido, poderá não receber esse bloco final com os dados de utilização. A ausência do bloco final não permite concluir que o pedido não utilizou tokens.
Esta configuração é específica de Chat Completions. Para mais detalhes, consulte a documentação de referência da API chat completions.
