Skip to content

Uso e custos ​

A aba Uso e custos resume as chamadas de API de modelo faturadas que este projeto fez — incluindo tentativas que foram posteriormente descartadas — com contagens de tokens e um custo único em USD.

Os mesmos agregados estão disponíveis na linha de comando como ai-i18n-tools usage.

Use-o para responder: quantas chamadas fizemos, quais modelos e operações gastaram tokens e qual foi o custo?

O que é registrado ​

Cada linha de detalhe é uma conclusão HTTP que retornou uso (mesmo que a tradução tenha sido posteriormente rejeitada por análise/script/qualidade e o próximo modelo de fallback tenha sido tentado). Falhas de transporte que nunca produziram um corpo faturado não são registradas.

Após a conclusão de um comando que chamou a API, as linhas anteriores a sete dias corridos completos em UTC (a partir das 00:00 UTC de hoje menos 7 dias) são consolidadas em totais mensais (api_totals) e removidas do log de detalhes. A última semana permanece como linhas api_calls individuais. As tabelas de resumo combinam ambas as fontes para o intervalo de tempo selecionado.

Relatório de custos ​

Cada chamada, cartão de resumo e tabela mostra um custo em USD:

  1. O usage.cost do provedor quando a resposta o incluía (OpenRouter e Cheaper Inference atualmente). Um custo reportado, incluindo 0, nunca é substituído.
  2. Caso contrário, o valor de providers.<name>.modelPricing ou o padrão pricing de todo o provedor, aplicado aos tokens de entrada e saída daquela chamada.
  3. Caso contrário, o preço de lista models.dev para aquele ID de modelo (USD de entrada e saída por 1 milhão de tokens), a partir do mesmo cache que suggest-models mantém. suggest-models --refresh atualiza esse cache. Uma tradução ou este relatório não baixa o languagebench ou o Arena apenas para precificar uma chamada.

Novas chamadas armazenam esse valor na linha api_calls. Linhas mais antigas que foram armazenadas sem um custo são precificadas da mesma forma quando o relatório é aberto, sendo então adicionadas ao mesmo valor de Custo — elas não são exibidas como uma segunda coluna. Se nenhuma das três fontes se aplicar, a célula fica —, nunca $0.00. Alterar as taxas configuradas ou uma atualização posterior do models.dev não reescreve linhas que já possuem um custo armazenado. Os consolidadores mensais ainda mantêm uma contagem de chamadas que armazenaram um custo (ncost_acc / ncost_dis), para que $0.00 permaneça distinto de “desconhecido” após a compactação.

Filtros ​

Filtre por janela de tempo, provedor, modelo, operação (translate-docs, translate-ui, translate-json, translate-svg, proofread-ui, bench-models), localidade e resultado (aceito vs. descartado).

Janelas de tempo:

  • Intervalos curtos (Last 30 minutes a Last 30 days) usam durações contínuas. Uso ao longo do tempo mostra uma linha por dia do calendário UTC que ainda tem detalhes nesse intervalo.
  • Last 2 months / Last 3 months começam às 00:00 UTC no primeiro dia do mês calendário atual menos 1 / 2 meses. Uso ao longo do tempo mostra as linhas diárias retidas mais uma linha por mês.
  • All time inclui todos os totais mensais e as linhas diárias retidas.

Para remover o uso antigo, escolha uma janela em Excluir entradas anteriores a (> 1 month, > 2 months, > 3 months, > 6 months, > 1 year ou all data (clear)) e, em seguida, Excluir dados. O menu começa em -, o que deixa Excluir dados desabilitado até que uma janela seja escolhida. As mesmas janelas estão disponíveis como ai-i18n-tools usage --clear [--older-than 1mo|2mo|3mo|6mo|1y|all]. Os limites de calendário mantêm o mês atual (1mo) ou o mês atual mais os meses anteriores.

Linha de comando ​

bash
ai-i18n-tools usage
# ai-i18n-tools usage --since 7d --operation translate-docs
# ai-i18n-tools usage --since 2mo
# ai-i18n-tools usage --clear --older-than 3mo --dry-run

Lançado sob a Licença MIT.