Интеграция и использование API перевода локализации

Основная функция API перевода локализации заключается в получении переведенного текста на основе введенного текста, при этом язык перевода можно настроить, а результаты перевода могут быть выведены в двух основных форматах: json и markdown. В этом документе подробно описывается интеграция API перевода, чтобы помочь вам легко интегрировать и в полной мере использовать мощные функции этого API. С помощью API перевода вы можете легко перевести введенный текст на определенный язык и поддерживать определенные способы вывода результатов перевода.

Процесс подачи заявки

Чтобы использовать API перевода локализации, сначала перейдите в консоль Ace Data Cloud, чтобы получить ваш API Token и сохранить его для использования.

Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вас пригласят зарегистрироваться и войти. После завершения вы будете автоматически возвращены на текущую страницу. Один API Token позволяет вызывать все сервисы платформы, не нужно подавать отдельные заявки для каждого сервиса. При первой подаче заявки предоставляется бесплатный лимит, чтобы вы могли попробовать; если лимит исчерпан, вы можете пополнить общий баланс в консоли.

📘 Полная документация: API перевода локализации →

Пример запроса

Рассмотрим пример с английским вводом, чтобы продемонстрировать, как использовать этот API. Предположим, английское описание: # Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph., далее покажем, как загрузить английское описание и получить перевод на китайский язык, при этом вывод будет в формате markdown.

Установка заголовков запроса и тела запроса

Request Headers включает:

accept: указывает на прием ответа в формате JSON, здесь указывается application/json.
authorization: ключ для вызова API, после запроса можно выбрать из выпадающего списка.

Request Body включает:

input: содержимое, которое нужно перевести. При extension=md передается строка, при extension=json передается JSON-объект.
locale: настраиваемый язык перевода.
extension: формат входного содержимого, может быть md или json.
model: большой модель, используемая для перевода, по умолчанию gpt-3.5.

`extension`	Тип `input`	Пример
`md`	string	`"# Title\n\nParagraph"`
`json`	object	`{"title": "Hello", "button": "Submit"}`

extension должен соответствовать типу input; строка не может использовать json, JSON-объект не может использовать md. Настройте, как показано на рисунке ниже:

Пример кода

Можно заметить, что на правой стороне страницы автоматически сгенерированы коды на различных языках, как показано на рисунке:

Некоторые примеры кода:

CURL

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

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 вернет информацию о результате этой задачи перевода. Например:

{
  "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: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
400 api_not_implemented: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
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"
}

Заключение

С помощью этого документа вы узнали, как использовать API перевода локализации для легкого перевода введенного текста на определенный язык и поддерживать определенные способы вывода результатов перевода. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Coding

Другие руководства

Интеграция и использование API перевода локализации

Процесс подачи заявки

Пример запроса

Установка заголовков запроса и тела запроса

Пример кода

CURL

Python

Пример ответа

Обработка ошибок

Пример ответа об ошибке

Заключение

​Процесс подачи заявки

​Пример запроса

​Установка заголовков запроса и тела запроса

​Пример кода

​CURL

​Python

​Пример ответа

​Обработка ошибок

​Пример ответа об ошибке

​Заключение

Процесс подачи заявки

Пример запроса

Установка заголовков запроса и тела запроса

Пример кода

CURL

Python

Пример ответа

Обработка ошибок

Пример ответа об ошибке

Заключение