Інтеграція та використання Localization Translate API

Основна функція Localization Translate API полягає в отриманні перекладеного тексту шляхом введення тексту, що потребує перекладу, при цьому мову перекладу можна налаштувати, а результати перекладу можуть бути виведені у двох основних форматах: json та markdown. Цей документ детально описує інструкції з інтеграції Translate API, щоб допомогти вам легко інтегрувати та повністю використовувати потужні можливості цього API. За допомогою Translate API ви можете легко реалізувати переклад введеного тексту на певну мову, а також підтримувати специфічні способи виведення результатів перекладу.

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

Щоб використовувати Localization Translate API, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, залиште його на випадок потреби.

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

📘 Повна документація: Localization Translate 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`	рядок	`"# Title\n\nParagraph"`
`json`	об’єкт	`{"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"
}

Висновок

Завдяки цьому документу ви дізналися, як використовувати Localization Translate API для легкого перекладу введеного тексту на певну мову, а також підтримувати специфічні способи виведення результатів перекладу. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Проксі

Advanced

Coding

Інтеграція та використання Localization Translate API

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

Приклад запиту

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Python

Приклад відповіді

Обробка помилок

Приклад помилки у відповіді

Висновок

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

​Приклад запиту

​Налаштування заголовків запиту та тіла запиту

​Приклад коду

​CURL

​Python

​Приклад відповіді

​Обробка помилок

​Приклад помилки у відповіді

​Висновок

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

Приклад запиту

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Python

Приклад відповіді

Обробка помилок

Приклад помилки у відповіді

Висновок