Obtenha relatórios detalhados sobre a utilização da API do DeepL com o parâmetro «Mostrar caracteres faturados»
Pontos-chave
- Os utilizadores da API do DeepL podem gerar relatórios sobre o número de caracteres cobrados por cada pedido de API bem-sucedido.
- O parâmetro show_billed_characters dá aos utilizadores acesso imediato aos dados de utilização da API diretamente na resposta da API.
- Esses dados de utilização por solicitação podem ser utilizados em relatórios personalizados e fluxos de trabalho de acompanhamento de custos diretamente a partir da API.
- Isto é especialmente útil para conteúdos estruturados como HTML ou XML, onde os caracteres traduzíveis podem ser mais difíceis de identificar.
- Esta função alarga os relatórios da API do DeepL para além do endpoint /usage e ajuda-o a monitorizar 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 necessidade de configuração adicional.
A API do DeepL sempre colocou os relatórios e a análise como uma prioridade para programadores e empresas como a sua. Isto aplica-se quer seja através do endpoint /usage diretamente na própria API, quer seja através da funcionalidade de relatórios para várias chaves de API.
A nossa equipa lançou esta adição conveniente à nossa lista crescente de ferramentas de relatórios: o show_billed_characters está agora disponível para todos os clientes da API.
Isto vem reforçar a funcionalidade de relatórios em expansão da API do DeepL. Permite agora uma visão detalhada do número de caracteres faturados nos dados de resposta para cada pedido de API.
Descubra como a API do DeepL o ajuda a fazer ainda mais com a nossa poderosa IA linguística.
O que é o parâmetro show_billed_characters?
Anteriormente, os utilizadores da API que pretendiam obter dados de utilização precisos diretamente da API do DeepL tinham uma única opção para chamar o endpoint /usage. Esta é uma forma eficaz de recuperar a utilização de caracteres mais atualizada para o período de faturação em curso. No entanto, não fornece uma repartição precisa dos caracteres traduzidos em cada pedido.
Um parâmetro opcional resolve este problema, devolvendo o número de caracteres traduzidos e faturados com a resposta de cada pedido de API bem-sucedido.
Descubra relatórios flexíveis ao nível da chave para utilizadores da API do DeepL.
Como funciona o parâmetro show_billed_characters?
Os clientes da API que efetuam pedidos diretamente à API, por exemplo, através de um comando cURL, podem adicionar o novo parâmetro show_billed_characters aos seus pedidos. Isto devolve o número de caracteres faturados como parte dos dados da resposta.
As respostas da API que envolvam um custo por carácter irão então devolver um novo valor inteiro no formato “billed_characters:50” em cada resposta.
Pode acompanhar este valor na extremidade do consumidor da API para utilização em fluxos de trabalho de relatórios e para acompanhar o custo de cada pedido individual da API.
Isto é especialmente importante para pedidos que contenham conteúdo estruturado, como HTML ou XML, onde pode ser difícil identificar os caracteres traduzíveis.
No futuro, a equipa da DeepL pretende incluir «billed_characters» na resposta da API do DeepL por predefinição. Nessa altura, 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, obtém uma resposta semelhante a esta ao enviar um pedido à API:
A sua resposta terá este aspeto se enviar um pedido utilizando o novo parâmetro show_billed_characters:
Veja as seis transformações na tradução que as empresas internacionais devem aproveitar agora.
Por que razão a DeepL adicionou relatórios de caracteres faturados por pedido
Vários clientes solicitaram esta ferramenta. Permite-lhe criar relatórios sobre a faturação por caracteres de forma granular e integrar esses dados diretamente nas suas próprias ferramentas de reporting a cada pedido de tradução bem-sucedido na API.
O parâmetro show_billed_characters está totalmente operacional na API do DeepL para os utilizadores — não é necessária qualquer configuração adicional.
Além disso, atualizámos a nossa documentação da API para refletir esta alteração, facilitando aos programadores como o senhor a integração desta funcionalidade nos seus fluxos de trabalho e a começar a 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-lhe uma forma flexível de integrar traduções de alta qualidade diretamente nas suas próprias ferramentas. Com funções como show_billed_characters, pode combinar esse poder de tradução com relatórios de utilização mais precisos e maior visibilidade dos custos.
Faz parte do mesmo conjunto de IA linguística que alimenta o Tradutor, o DeepL Write e o DeepL Voice — assim, à medida que as suas necessidades de tradução crescem, a infraestrutura subjacente adapta-se às suas necessidades.
Explore a API do DeepL, ou contacte o departamento de vendas para discutir as necessidades de relatórios e integração da sua empresa.