Consigue un desglose detallado del uso de la API con el parámetro de DeepL «mostrar caracteres facturados»
Aspectos clave
- Los usuarios de la API de DeepL pueden llevar un seguimiento del número de caracteres facturados por cada petición de API que se haya completado correctamente.
- El parámetro show_billed_characters proporciona a los usuarios acceso inmediato a los datos de uso de la API directamente en la respuesta de la petición.
- Dichos datos de uso permiten crear informes personalizados y gestionar flujos de trabajo para llevar un seguimiento de costes directamente desde la propia API.
- Esto resulta especialmente útil para contenido estructurado como HTML o XML, donde los caracteres traducibles pueden ser más difíciles de identificar.
- La función amplía los informes de la API de DeepL más allá del punto final /usage y te permite supervisar la actividad de traducción con mayor precisión.
- El nuevo parámetro show_billed_characters ya está disponible para todos los clientes de la API de DeepL sin configuración adicional.
La API de DeepL siempre ha priorizado los informes y análisis para desarrolladores y empresas como la tuya. Esto es aplicable tanto si accedes desde el punto final /usage directamente en la propia API como a través de la funcionalidad de informes para múltiples claves de API.
Nuestro equipo ha incorporado esta práctica novedad a nuestra creciente lista de herramientas de informes: show_billed_characters ya está disponible para todos los clientes de la API.
Esto se suma a la creciente funcionalidad de informes de la API de DeepL. Ahora podrás ver con total precisión cuántos caracteres se facturan en los datos de respuesta de cada petición de API.
Descubre cómo la API de DeepL te ayuda a sacarle aún más partido a nuestra IA lingüística avanzada.
¿Qué función tiene el parámetro show_billed_characters?
Hasta ahora, la única forma que tenían los usuarios de la API de obtener datos de uso precisos directamente desde la API de DeepL era llamando al punto final /usage. Es una manera muy eficaz de consultar el consumo de caracteres más reciente del periodo de facturación actual. No obstante, no ofrece un desglose exacto de los caracteres traducidos en cada petición.
Para solucionar esta limitación, se ha añadido un parámetro opcional que incluye el número de caracteres traducidos y facturados junto con la respuesta a cada petición de API que se haya completado correctamente.
Descubre los informes flexibles de uso individuales por clave para los usuarios de la API de DeepL.
¿Cómo funciona el parámetro show_billed_characters?
Los clientes de la API que envíen peticiones directamente a la API, por ejemplo, mediante un comando cURL, pueden añadir el nuevo parámetro show_billed_characters a sus consultas. Así, el número de caracteres facturados aparecerá en los datos de respuesta.
Las respuestas de la API que conlleven un coste por caracteres incluirán a partir de ahora un nuevo valor entero con el formato «billed_characters:50».
Puedes llevar un seguimiento de este valor desde el lado del cliente de la API para utilizarlo en informes y controlar el coste de cada petición de API individual.
Esta función es especialmente importante para peticiones con contenido estructurado (como HTML o XML), donde puede resultar difícil identificar los caracteres traducibles.
En el futuro, el equipo de DeepL tiene previsto incluir «billed_characters» en la respuesta de la API por defecto. A partir de entonces, será necesario definir show_billed_characters como «false» para excluir «billed_characters» de la respuesta de la API.
Descubre cómo DeepL refuerza la seguridad con múltiples claves de API.
Ejemplo de respuesta de la API con show_billed_characters
Actualmente, obtienes una respuesta similar a esta al enviar una petición a la API:
Al incluir el nuevo parámetro show_billed_characters, la respuesta será así:
Por qué DeepL incluye ahora informes de caracteres facturados por petición
Varios clientes han solicitado esta herramienta. Te permite llevar un seguimiento detallado de la facturación por caracteres e integrar esos datos directamente en tus propias herramientas de informes con cada petición de traducción de la API que se complete correctamente.
El parámetro show_billed_characters ya está plenamente operativo en la API de DeepL para los usuarios de DeepL, sin necesidad de configuración adicional.
Además, hemos actualizado la documentación de la API para incorporar este cambio y que los desarrolladores como tú podáis integrarlo en vuestros flujos de trabajo para lograr traducciones más precisas.
Para obtener más información, consulta Descripciones del cuerpo de la petición y Notas de la versión.
Optimiza tus informes con la API de DeepL