Obtenha relatórios detalhados sobre o consumo da API do DeepL com o parâmetro “Mostrar caracteres cobrados” do DeepL
Principais conclusões
- Os usuários da API do DeepL podem gerar relatórios sobre o número de caracteres cobrados para cada solicitação de API bem-sucedida.
- O parâmetro show_billed_characters dá aos usuários acesso imediato aos dados de consumo da API diretamente na resposta da API.
- Esses dados de consumo por solicitação podem ser usados em relatórios personalizados e fluxos de trabalho de controle de custos diretamente da API.
- Isso é especialmente útil para conteúdos estruturados como HTML ou XML, onde os caracteres traduzíveis podem ser mais difíceis de identificar.
- O recurso amplia os relatórios da API do DeepL além do ponto de extremidade /usage e ajuda você a monitorar a atividade de tradução com maior precisão.
- O novo parâmetro show_billed_characters já está disponível para todos os clientes da API do DeepL sem nenhuma configuração adicional.
A API do DeepL sempre colocou relatórios e análises como prioridade para desenvolvedores e empresas como a tua. Isso vale tanto para o ponto de extremidade /usage diretamente na própria API quanto para a funcionalidade de relatórios para várias chaves de API.
Nossa equipe lançou essa adição prática à nossa lista crescente de ferramentas de relatórios: o show_billed_characters agora está disponível para todos os clientes da API.
Isso amplia a funcionalidade de relatórios da API do DeepL. Agora, ela permite uma visão detalhada de quantos caracteres são cobrados nos dados de resposta para cada solicitação de API.
Descubra como a API do DeepL te ajuda a fazer ainda mais com nossa poderosa IA linguística.
O que é o parâmetro show_billed_characters?
Antes, os usuários da API que queriam obter dados precisos de consumo diretamente da API do DeepL tinham apenas uma opção: chamar o ponto de extremidade /usage. Essa é uma maneira poderosa de recuperar o consumo de caracteres mais atualizado para o período de cobrança em curso. No entanto, ela não fornece uma divisão precisa dos caracteres traduzidos em cada solicitação.
Um parâmetro opcional resolve esse problema, retornando o número de caracteres traduzidos e faturados junto com a resposta de cada solicitação de API bem-sucedida.
Descubra relatórios flexíveis por chave para usuários da API do DeepL.
Como funciona o parâmetro show_billed_characters?
Clientes da API que fazem solicitações diretamente à API, como por meio de um comando cURL, podem adicionar o novo parâmetro show_billed_characters às suas solicitações. Isso retorna o número de caracteres cobrados como parte dos dados da resposta.
Respostas da API com custo por caractere incluirão então um novo valor inteiro no formato “billed_characters:50” em cada resposta.
Você pode acompanhar esse valor no lado do usuário da API para usar em fluxos de trabalho de relatórios e para monitorar o custo de cada solicitação de API individual.
Isso é especialmente importante para solicitações que contêm conteúdo estruturado, como HTML ou XML, onde pode ser difícil identificar os caracteres traduzíveis.
No futuro, a equipe do DeepL pretende incluir billed_characters na resposta da API do DeepL por padrão. Nesse momento, será necessário definir show_billed_characters como “false” para não incluir “billed_characters” na resposta da API.
Saiba como o DeepL reforça a segurança com várias chaves de API.
Como fica a resposta da API com show_billed_characters
Atualmente, você recebe uma resposta semelhante a esta ao enviar uma solicitação para a API:
Sua resposta ficará assim se você enviar uma solicitação usando o novo parâmetro show_billed_characters:
Veja as seis transformações na tradução que as empresas internacionais devem aproveitar agora.
Por que o DeepL adicionou relatórios de caracteres cobrados por solicitação
Vários clientes solicitaram essa ferramenta. Ela permite que você gere relatórios de cobrança por caractere de forma detalhada e integre esses dados diretamente às suas próprias ferramentas de relatórios a cada solicitação de tradução bem-sucedida na API.
O parâmetro show_billed_characters já está totalmente operacional na API do DeepL para usuários — sem necessidade de configuração adicional.
Além disso, atualizamos nossa documentação da API para refletir essa mudança, facilitando para desenvolvedores como você integrarem isso aos seus fluxos de trabalho e começarem a se beneficiar de uma maior precisão de tradução.
Para mais informações, leia Descrições do corpo da solicitação e Notas de lançamento.
Crie relatórios mais inteligentes com a API do DeepL
API do DeepL oferece uma maneira flexível de incorporar traduções de alta qualidade diretamente nas tuas próprias ferramentas. Com recursos como show_billed_characters, você pode combinar esse poder de tradução com relatórios de consumo mais precisos e visibilidade de custos.
Isso faz parte do mesmo pacote de IA linguística que alimenta o Translator, o Write e o Voice — assim, à medida que suas necessidades de tradução crescem, a infraestrutura subjacente se adapta com você.
Explore a API do DeepL, ou entre em contato com o departamento de vendas para discutir as necessidades de relatórios e integração da sua empresa.