Перейти до основного вмісту

​
Вступ

Localization — це сервіс інструментів, який надає Ace Data Cloud для AI перекладу та локалізації. Через уніфікований API Ace Data Cloud ви можете швидко інтегрувати Localization за допомогою JavaScript, реалізуючи переклад Markdown, JSON, підтримку 18 мов, збереження форматування та інші функції.

​
Попередні умови

  • Мати акаунт Ace Data Cloud та отримати API Token
  • Node.js 18+ або сучасне браузерне середовище

​
Базове використання

Основний endpoint для виклику Localization API: 
POST https://api.acedata.cloud/localization/translate
У цьому прикладі використовується модель gpt-4. Доступні моделі: gpt-3.5, gpt-4. Повний приклад коду на JavaScript: 
const response = await fetch("https://api.acedata.cloud/localization/translate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "input": "# 欢迎使用\n\n这是一段示例文本。",
  "locale": "en",
  "extension": "md",
  "model": "gpt-4"
}),
});

const result = await response.json();
console.log(result);
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Обробка відповіді

Рекомендується перевіряти статус відповіді та обробляти помилки: 
if (response.ok) {
  const result = await response.json();
  console.log("Виклик успішний:", result);
} else {
  console.error(`Виклик не вдався, статус: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Обгортка для Node.js

Рекомендується обгорнути у багаторазову функцію: 
async function callLocalization(data) {
  const response = await fetch("https://api.acedata.cloud/localization/translate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

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

Поширені коди помилок:
Код статусуОпис
401Аутентифікація не вдалася, перевірте API Token
403Недостатньо коштів або відсутній доступ
429Перевищено ліміт частоти запитів
500Внутрішня помилка сервера

​
Наступні кроки