Интеграция и использование 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.

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

Заголовки запроса включают:

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

Тело запроса включает:

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

Настройка показана на следующем изображении:

Пример кода

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

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

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

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

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

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

Заключение