Localization Translate API 集成与使用指南

在全球化的今天，语言的障碍常常成为沟通和信息传播的障碍。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 的技术支持团队。

技术标签

#API集成
#翻译服务
#AceDataCloud
#Python开发
#CURL使用

Localization Translate API 集成与使用指南