DeepL의 ‘청구된 글자 수 표시’ 매개변수를 통해 상세한 API 사용 현황 보고서를 확인하세요

핵심 사항
- DeepL API 사용자는 성공한 각 API 요청에 대해 청구된 글자 수를 보고할 수 있습니다.
- show_billed_characters 매개변수를 사용하면 API 응답에서 바로 API 사용량 데이터에 액세스할 수 있습니다.
- 이러한 요청별 사용량 데이터는 API에서 직접 사용자 지정 보고서 및 비용 추적 워크플로에 활용할 수 있습니다.
- 이는 번역 가능한 글자를 식별하기 어려울 수 있는 HTML이나 XML과 같은 구조화된 콘텐츠에 특히 유용합니다.
- 이 기능은 DeepL API 보고서를 /usage 엔드포인트 이상으로 확장하여 번역 활동을 보다 정확하게 모니터링할 수 있도록 도와줍니다.
- 새로운 show_billed_characters 매개 변수는 별도의 설정 없이 모든 DeepL API 고객이 이미 사용할 수 있습니다.
DeepL API는 항상 귀사와 같은 개발자 및 비즈니스를 위해 보고 및 분석을 최우선으로 여겨 왔습니다. 이는 API 자체의 /usage 엔드포인트를 직접 이용하는 경우든, 다중 API 키에 대한 보고서 기능을 이용하는 경우든 상관없이 적용됩니다.
저희 팀은 점점 늘어나는 보고서 도구 목록에 이 편리한 기능을 추가하여, 이제 모든 API 고객이 show_billed_characters를 사용할 수 있게 되었습니다.
이는 DeepL API의 확장되는 보고서 기능에 추가된 것입니다. 이제 각 API 요청에 대한 응답 데이터에서 청구된 글자 수를 세밀하게 확인할 수 있습니다.
DeepL API가 강력한 언어 AI를 통해 어떻게 더 많은 일을 할 수 있도록 도와주는지 알아보세요.
show_billed_characters 매개 변수는 무엇일까요?
이전에는 DeepL API에서 정확한 사용량 데이터를 직접 얻고자 하는 API 사용자에게 /usage 엔드포인트를 호출하는 단 하나의 옵션만 있었습니다. 이는 현재 청구 기간의 최신 글자 사용량을 확인하는 강력한 방법입니다. 그러나 이 방법으로는 각 요청에서 번역된 글자의 정확한 내역을 확인할 수 없습니다.
선택적 매개 변수를 사용하면 성공적인 API 요청의 응답과 함께 번역 및 청구된 글자 수를 반환하여 이 문제를 해결할 수 있습니다.
DeepL API 사용자를 위한 유연한 키 수준 보고서 기능 알아보기.
show_billed_characters 매개 변수는 어떻게 작동하나요?
cURL 명령을 통해 API에 직접 요청을 보내는 API 고객은 요청에 새로운 show_billed_characters 매개 변수를 추가할 수 있습니다. 그러면 응답 데이터의 일부로 청구된 글자 수가 반환됩니다.
문자 비용이 포함된 API 응답은 모든 응답에 대해 “billed_characters:50” 형식의 새로운 정수 값을 반환합니다.
API 사용자 측에서 이 값을 추적하여 보고서 워크플로에 활용하고, 개인별 API 요청의 비용을 추적할 수 있습니다.
이는 HTML이나 XML과 같은 구조화된 콘텐츠가 포함된 요청의 경우, 번역 가능한 글자를 식별하기 어려울 수 있으므로 특히 중요합니다.
향후 DeepL 팀은 기본적으로 API 응답에 billed_characters를 포함할 계획입니다. 그때는 API 응답에 "billed_characters"를 포함하지 않으려면 show_billed_characters를 "false"로 설정해야 합니다.
DeepL이 다중 API 키를 사용하여 보안을 강화하는 방법 알아보기.
show_billed_characters가 포함된 API 응답의 예시
현재 API에 요청을 보내면 다음과 유사한 응답을 받게 됩니다:

새로운 show_billed_characters 매개변수를 사용하여 요청을 보내면 응답은 다음과 같이 표시됩니다:

글로벌 기업이 지금 바로 활용해야 할 6가지 번역 혁신 전략 확인하기.
DeepL이 요청당 청구 글자 수 보고 기능을 추가한 이유
많은 고객분들이 이 기능을 요청해 주셨습니다. 이를 통해 API 번역 요청이 성공할 때마다 자당 과금 내역을 세분화하여 보고서를 작성하고, 해당 데이터를 자체 보고 도구에 직접 통합할 수 있습니다.
show_billed_characters 매개 변수는 DeepL 사용자를 위해 API 내에서 완벽하게 작동하며, 별도의 설정이 필요하지 않습니다.
또한, 이러한 변경 사항을 반영하여 API 기술문서를 업데이트했으므로, 개발자 여러분은 이를 워크플로에 쉽게 통합하고 더 높은 번역 정확도의 이점을 누릴 수 있습니다.
DeepL 도구가 진정한 국경 없는 비즈니스를 위해 AI 번역을 어떻게 변화시키고 있는지 확인해 보세요.
DeepL API로 더 스마트한 보고서를 작성하세요