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

Вступ

Image2Text — це сервіс розпізнавання капчі, що надається Ace Data Cloud, для розпізнавання зображень капчі. За допомогою уніфікованого API Ace Data Cloud ви можете швидко інтегрувати Image2Text за допомогою JavaScript, реалізуючи розпізнавання капчі зображень, введення у форматі Base64, введення за URL тощо.

Передумови

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

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

Основна кінцева точка для виклику Image2Text API:
POST https://api.acedata.cloud/captcha/recognition/image2text
Повний приклад коду на JavaScript:
const response = await fetch("https://api.acedata.cloud/captcha/recognition/image2text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}),
});

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 callImage2Text(data) {
  const response = await fetch("https://api.acedata.cloud/captcha/recognition/image2text", {
    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Внутрішня помилка сервера

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