Получайте подробные отчеты об использовании API с помощью параметра DeepL «Показать количество оплачиваемых символов»

Основные выводы

• Пользователи API от DeepL могут получать отчеты о количестве символов, за которые взимается плата, по каждому успешному запросу API.
• Параметр show_billed_characters предоставляет пользователям мгновенный доступ к данным об использовании API непосредственно в ответе API.
• Эти данные об использовании по каждому запросу можно использовать в пользовательских отчетах и рабочих процессах по отслеживанию затрат непосредственно из API.
• Это особенно полезно для структурированного контента, такого как HTML или XML, где переводимые символы бывает сложнее идентифицировать.
• Эта функция расширяет возможности отчетности API от DeepL за пределы конечной точки /usage и помогает вам с большей точностью отслеживать активность перевода.
• Новый параметр show_billed_characters уже доступен всем клиентам API от DeepL без дополнительной настройки.

API от DeepL всегда уделял приоритетное внимание отчетности и аналитике для разработчиков и таких компаний, как ваша. Это относится как к конечной точке /usage непосредственно в самом API, так и к функции отчетности для нескольких ключей API.

Наша команда выпустила это удобное дополнение к нашему растущему списку инструментов отчетности: show_billed_characters теперь доступен всем клиентам API.

Это дополняет расширяющиеся возможности API от DeepL в области отчетности. Теперь она позволяет получить подробную информацию о том, сколько символов учитывается в данных ответа для каждого запроса API.

Узнайте, как API от DeepL поможет вам добиться еще большего с помощью нашего мощного языкового ИИ.

Что такое параметр show_billed_characters?

Ранее у пользователей API, желающих получить точные данные об использовании непосредственно из API от DeepL, был единственный вариант — вызов конечной точки /usage. Это эффективный способ получения самых актуальных данных об использовании символов за текущий расчетный период. Однако он не предоставляет точную разбивку символов, переводимых в каждом запросе.

Дополнительный параметр решает эту проблему, возвращая количество переведенных и выставленных в счёт символов в ответе на каждый успешный запрос API.

Откройте для себя гибкую отчетность на уровне ключей для пользователей API от DeepL.

Как работает параметр show_billed_characters?

Клиенты API, отправляющие запросы напрямую в API, например с помощью команды cURL, могут добавить новый параметр show_billed_characters в свои запросы. В результате в данных ответа будет возвращаться количество символов, за которые начислена оплата. 

Ответы API, в которых учитывается стоимость символов, будут возвращать новое целое число в формате «billed_characters:50» в каждом ответе.

Вы можете отслеживать это значение на стороне потребителя API для использования в рабочих процессах отчетности и для отслеживания стоимости каждого отдельного запроса API.

Это особенно важно для запросов, содержащих структурированный контент, например HTML или XML, где может быть сложно определить переводимые символы.

В будущем команда DeepL планирует по умолчанию включать поле billed_characters в ответ API. В этом случае необходимо будет установить для параметра show_billed_characters значение «false», чтобы не включать «billed_characters» в ответ API.

Узнайте, как DeepL усиливает безопасность с помощью нескольких ключей API.

Как выглядит ответ API с параметром show_billed_characters

В настоящее время при отправке запроса к API вы получаете ответ, похожий на следующий:

Ваш ответ будет выглядеть следующим образом, если вы отправите запрос с использованием нового параметра show_billed_characters:

Ознакомьтесь с шестью преобразованиями в сфере перевода, которые глобальные предприятия должны внедрить уже сейчас.

Почему DeepL добавила отчетность по количеству оплачиваемых символов за запрос

Ряд клиентов запросили этот инструмент. Он позволяет вам создавать подробные отчеты по количеству оплачиваемых символов и интегрировать эти данные непосредственно в ваши собственные инструменты отчетности при каждом успешном запросе на перевод через API.

Параметр show_billed_characters полностью доступен в API от DeepL для пользователей — никакой дополнительной настройки не требуется. 

Кроме того, мы обновили документацию API с учётом этого изменения, чтобы вам, как разработчикам, было проще интегрировать эту функцию в свои рабочие процессы и начать пользоваться преимуществами более точного перевода.

Для получения дополнительной информации ознакомьтесь с Описанием тела запроса и Примечаниями к выпуску.

Узнайте, как инструменты DeepL преобразуют перевод с помощью ИИ для бизнеса, не знающего границ.

Создавайте более эффективные отчеты с помощью API от DeepL

API от DeepL предоставляет вам гибкий способ встраивания высококачественного перевода непосредственно в ваши собственные инструменты. Благодаря таким функциям, как show_billed_characters, вы можете совместить эту мощь перевода с более точной отчетностью об использовании и прозрачностью затрат. 

Это часть того же набора решений языкового ИИ, на котором работают Переводчик, Write и Voice — поэтому по мере роста ваших потребностей в переводе базовая инфраструктура масштабируется вместе с вами. 

Ознакомьтесь с API от DeepL или свяжитесь с отделом продаж для обсуждения потребностей в отчетности и интеграции для предприятий.