在全球化的今天语言的障碍常常成为沟通和信息传播的障碍。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。设置示例如下图所示代码示例在页面右侧您可以看到各种语言代码的自动生成如下图所示以下是一些代码示例CURLcurl -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 }Pythonimport 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, jsonpayload, headersheaders) print(response.text)响应示例成功请求后API 将返回翻译任务的结果信息。例如{ 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: 服务器内部错误。错误响应示例{ success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }总结通过本文您已学会如何使用 Localization Translate API 将输入文本翻译为特定语言并支持多种格式输出翻译结果。希望本指南能帮助您更好地集成和使用此 API。如果您有任何问题请随时联系 Ace Data Cloud 的技术支持团队。相关链接Ace Data Cloud 官网API 文档技术标签API集成翻译服务AceDataCloudPython开发CURL使用
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。设置示例如下图所示代码示例在页面右侧您可以看到各种语言代码的自动生成如下图所示以下是一些代码示例CURLcurl -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 }Pythonimport 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, jsonpayload, headersheaders) print(response.text)响应示例成功请求后API 将返回翻译任务的结果信息。例如{ 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: 服务器内部错误。错误响应示例{ success: false, error: { code: api_error, message: fetch failed }, trace_id: 2cf86e86-22a4-46e1-ac2f-032c0f2a4e89 }总结通过本文您已学会如何使用 Localization Translate API 将输入文本翻译为特定语言并支持多种格式输出翻译结果。希望本指南能帮助您更好地集成和使用此 API。如果您有任何问题请随时联系 Ace Data Cloud 的技术支持团队。相关链接Ace Data Cloud 官网API 文档技术标签API集成翻译服务AceDataCloudPython开发CURL使用
