使用 DeepL 的“显示计费字符”参数获取详细的 API 使用报告
核心要点
- DeepL API 用户可针对每次成功的 API 请求生成计费字符数的报告。
- show_billed_characters 参数让用户能够直接在 API 响应中即时获取 API 使用数据。
- 这些按请求统计的使用数据可直接用于 API 中的自定义报告和成本跟踪工作流。
- 对于 HTML 或 XML 等结构化内容，该功能尤为有用，因为此类内容中可翻译的字符往往难以识别。
- 该功能将 DeepL API 报告扩展到了 /usage 端点之外，并帮助您更精确地监控翻译活动。
- 所有 DeepL API 客户均可立即使用新的 show_billed_characters 参数，无需额外设置。
DeepL API 一直将报告和分析作为像您这样的开发者和企业的优先事项。无论您是通过 API 本身的 /usage 端点，还是通过针对 多个 API 密钥 的报告功能，我们都秉持这一理念。
我们的团队在不断扩充的报告工具列表中新增了这一便捷功能：show_billed_characters 现已向所有 API 用户开放。
这进一步丰富了 DeepL API 不断扩展的报告功能。现在，您可以详细查看每次 API 请求的响应数据中计费的字符数量。
探索 DeepL API 如何借助我们强大的语言人工智能助您实现更多可能.
什么是 show_billed_characters 参数？
此前，希望直接从 DeepL API 获取准确使用数据的 API 用户只有一种选择，即调用 /usage 端点。这是获取当前计费期最新字符使用情况的一种有效方法。然而，它无法准确细分每次请求中被翻译的字符。
一个可选参数通过在每次成功的 API 请求响应中返回已翻译并计费的字符数，解决了这个问题。
show_billed_characters 参数如何工作？
直接向 API 发送请求的 API 客户（例如通过 cURL 命令），可以在请求中添加新的 show_billed_characters 参数。这将返回作为响应数据一部分的计费字符数。
涉及字符费用的 API 响应将在每次响应中返回一个格式为“billed_characters:50”的新整数值。
您可以在 API 用户端跟踪此值，将其用于报告工作流，并跟踪每个 API 请求的成本。
对于包含 HTML 或 XML 等结构化内容的请求，这尤其重要，因为在这些请求中，可能难以识别可翻译的字符。
将来，DeepL 团队计划默认在 API 响应中包含 billed_characters。届时，若要避免在 API 响应中包含“billed_characters”，则需将 show_billed_characters 设置为“false”。
启用 show_billed_characters 时 API 响应的样式
目前，向 API 发送请求时，您会收到类似以下的响应：
如果您使用新的 show_billed_characters 参数发送请求，响应将如下所示：
DeepL为何新增按请求计费的字符报告功能
许多客户都曾要求提供此功能。该功能可让您以精细粒度报告字符计费情况，并能将每次成功的 API 翻译请求数据直接集成到您自己的报告工具中。
show_billed_characters 参数已在 DeepL API 中全面启用——无需额外配置。
此外，我们已更新 API 技术文件以反映这一变更，让您这样的开发者能够轻松将其集成到工作流程中，并 开始享受更高的翻译准确度。
了解 DeepL 工具如何革新人工智能翻译，助力实现真正无国界的企业.
使用 DeepL API 构建更智能的报告
DeepL API 为您提供了一种灵活的方式，可将高质量的翻译直接嵌入到您自己的工具中。借助 show_billed_characters 等功能，您可以将强大的翻译能力与更精准的使用报告及成本透明度相结合。
它隶属于同一套 语言人工智能套件，该套件还支持 翻译器、Write 和 Voice——因此，随着您的翻译需求增长，底层基础设施将随之扩展。
探索 DeepL API，或 联系销售团队 讨论企业级报告与集成需求。