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

Вступ

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

Передумови

  • Мати акаунт Ace Data Cloud та отримати API Token
  • Середовище Python 3.7 і вище
  • Встановлений пакет requests: pip install requests

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

Основна кінцева точка для виклику Face Change API:
POST https://api.acedata.cloud/face/swap
Повний приклад коду на Python:
import requests

url = "https://api.acedata.cloud/face/swap"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "source_image_url": "https://example.com/source-face.jpg",
    "target_image_url": "https://example.com/target-face.jpg"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

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

Після успішного виклику API повертає дані у форматі JSON. Рекомендується перевіряти HTTP статус-код:
if response.status_code == 200:
    result = response.json()
    print("Виклик успішний:", result)
else:
    print(f"Виклик не вдався, статус код: {response.status_code}")
    print(response.text)

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

Для API, що підтримують асинхронні завдання, можна отримати результат через callback URL:
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Результат буде надіслано на ваш сервер через callback URL

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

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

Інші кінцеві точки

Сервіс Face Change також надає наступні кінцеві точки:
  • POST https://api.acedata.cloud/face/beautify
  • POST https://api.acedata.cloud/face/change-age
  • POST https://api.acedata.cloud/face/change-gender
  • POST https://api.acedata.cloud/face/cartoon
  • POST https://api.acedata.cloud/face/analyze

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