Localization Translate API 的对接和使用
内容提要
本文介绍Localization Translate API的对接与使用。该API通过输入文本、指定目标语言和输出格式（JSON或Markdown），即可获得翻译结果。文章涵盖申请流程（获取API Token）、请求示例（含CURL和Python代码）、响应格式及错误处理，帮助开发者快速集成此翻译服务。
延伸解读
API Token 通用性
文章指出，一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。这意味着开发者只需一次认证，即可访问 Ace Data Cloud 平台上的多种 API，简化了集成流程。但需注意，Token 是敏感信息，应妥善保管，避免泄露。
输出格式选择
该 API 支持 JSON 和 Markdown 两种输出格式，通过 extension 参数指定。Markdown 格式适合直接用于文档或网页渲染，而 JSON 格式便于程序解析。开发者可根据实际应用场景灵活选择，例如在需要结构化数据时使用 JSON，在需要直接展示时使用 Markdown。
错误处理要点
文章列出了常见的错误代码，如 400（参数错误）、401（无效 Token）、429（请求过多）和 500（服务器错误）。开发者应在代码中处理这些错误，例如检查参数、更新 Token、实现重试机制等。错误响应中包含 trace_id，可用于向技术支持反馈问题。
Q&A
如何获取 Localization Translate API 的 API Token？
需要先到 Ace Data Cloud 控制台获取 API Token。如果尚未登录或注册，会自动跳转到登录页面，注册登录后会自动返回当前页面。一个 API Token 即可调用平台所有服务，首次申请会赠送免费额度。
Localization Translate API 支持哪些输出格式？
支持 JSON 和 Markdown 两种主流输出格式，通过请求体中的 extension 字段指定，例如 'md' 表示 Markdown 格式。
Localization Translate API 的请求参数有哪些？
请求体包含四个参数：input（要翻译的文本）、locale（目标语言，如 zh-CN）、extension（输出格式，如 md）、model（使用的模型，默认 gpt-3.5）。
如何使用 Python 调用 Localization Translate API？
使用 requests 库发送 POST 请求到 https://api.acedata.cloud/localization/translate，设置请求头（accept、authorization、content-type）和请求体（input、locale、extension），然后打印响应文本。
Localization Translate API 的响应结果包含哪些字段？
响应结果包含 data（翻译后的文本）、usage（token 使用量）、model（使用的模型）、locale（翻译语言）等字段。
调用 Localization Translate API 时遇到 401 错误怎么办？
401 错误表示 invalid_token，即授权 token 无效或缺失。需要检查请求头中的 authorization 字段是否正确，确保使用了有效的 API Token。
