Отримуйте детальні повідомлення про використання API за допомогою параметра DeepL «Показати кількість символів, за які нараховано плату»

Ключові висновки

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

DeepL API завжди ставив звітність та аналіз у пріоритет для розробників та бізнесів, таких як ваше. Це стосується як кінцевої точки /usage безпосередньо в самому API, так і функції повідомлень для кілька ключів API.

Наша команда випустила це зручне доповнення до нашого зростаючого переліку інструментів звітності: show_billed_characters тепер доступний для всіх клієнтів API.

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

Дізнайтеся, як DeepL API допомагає вам зробити ще більше за допомогою нашого потужного мовного ШІ.

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

Раніше користувачі API, які хотіли отримати точні дані про використання безпосередньо з DeepL API, мали єдину можливість — викликати кінцеву точку /usage. Це потужний спосіб отримання найактуальніших даних про використання символів за поточний розрахунковий період. Однак він не надає точного розбиття символів, що перекладаються в кожному запиті.

Опціональний параметр вирішує цю проблему, повертаючи кількість перекладених і оплачених символів у відповіді на кожен успішний запит API.

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

Як працює параметр 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 трансформують переклад на основі ШІ для бізнесу, що не знає кордонів.

Створюйте розумніші звіти за допомогою DeepL API

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

Це частина того самого пакета мовного ШІ, на якому працюють Перекладач, Write та Voice — тож у міру зростання ваших потреб у перекладі базова інфраструктура масштабується разом із вами. 

Ознайомтеся з DeepL API або зверніться до відділу продажів, щоб обговорити потреби підприємства щодо звітності та інтеграції.