在全球化的今天，语言的障碍常常成为沟通和信息传播的障碍。Ace Data Cloud 提供的 Localization Translate API 是一款强大的工具，能够通过输入需要翻译的文本，返回对应的翻译结果，并且支持多种语言的定制化选择。翻译结果可以以 json 或 markdown 格式输出，方便开发者在不同场景中进行使用。
本文将详细介绍如何集成和使用 Localization Translate API，帮助您快速上手并充分利用其强大功能。
环境准备/前置条件
在使用 Localization Translate API 之前，您需要在 Ace Data Cloud 的应用页面申请相应的服务。以下是申请步骤：
- 访问 Localization Translate API 页面。
- 点击"Acquire"按钮（如下图所示）：
- 如果您未登录，系统会引导您到 登录页面，请按提示注册或登录。
- 首次申请的用户可以享受免费配额，使用 API 无需费用。
详细步骤
请求示例
以下是使用 API 的基本步骤。我们以英文输入为例，假设需要翻译的内容为：
# Title 1
This is a paragraph.
## Title 2
This is another paragraph.我们将演示如何上传该英文描述并获取中文翻译结果，并以 markdown 格式显示。
设置请求头和请求体
请求头包括：
accept: 指定响应结果的格式，设置为application/json。authorization: 调用 API 的密钥，您可以在申请后直接获取。
请求体包括：
input: 需要翻译的文本。locale: 翻译语言。extension: 显示翻译结果的格式。model: 使用的翻译大模型，默认为 gpt-3.5。
设置示例如下图所示：
代码示例
在页面右侧，您可以看到各种语言代码的自动生成，如下图所示：
以下是一些代码示例：
CURL
bash
curl -X POST 'https://api.acedata.cloud/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
"locale": "zh-CN",
"extension": "md"
}'Python
python
import requests
url = "https://api.acedata.cloud/localization/translate"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
"locale": "zh-CN",
"extension": "md"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)响应示例
成功请求后，API 将返回翻译任务的结果信息。例如：
json
{
"data": "# 标题 1\n\n这是一个段落。\n\n## 标题 2\n\n这是另一个段落。",
"usage": {
"prompt_tokens": 172,
"completion_tokens": 25
},
"model": "gpt-3.5-turbo-16k",
"locale": "zh-CN"
}可以看到，结果中包含 data 字段，返回的翻译内容为中文，格式为 markdown。其他信息包括：
data: 翻译任务的结果。model: 用于翻译的语言模型。locale: 翻译任务的语言类型。
常见问题
在调用 API 时，如果发生错误，API 将返回相应的错误代码和信息。例如：
400 token_mismatched: 错误请求，可能是缺少或无效参数。401 invalid_token: 未授权，令牌无效或缺失。429 too_many_requests: 请求过多，超出速率限制。500 api_error: 服务器内部错误。
错误响应示例
json
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}总结
通过本文，您已学会如何使用 Localization Translate API 将输入文本翻译为特定语言，并支持多种格式输出翻译结果。希望本指南能帮助您更好地集成和使用此 API。如果您有任何问题，请随时联系 Ace Data Cloud 的技术支持团队。