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

​
Вступ

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

​
Передумови

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

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

Основна кінцева точка для виклику Face Change API: 
POST https://api.acedata.cloud/face/swap
Повний приклад коду на JavaScript: 
const response = await fetch("https://api.acedata.cloud/face/swap", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "source_image_url": "https://example.com/source-face.jpg",
  "target_image_url": "https://example.com/target-face.jpg"
}),
});

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

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