Перейти до основного вмісту
У цій статті буде представлено інструкцію з інтеграції API для покращення обличчя, який може точно визначити риси обличчя, завантаживши зображення обличчя користувача (максимум п’ять облич на одній фотографії), реалізуючи функції покращення шкіри, освітлення шкіри, видалення вугрів тощо.

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

Щоб використовувати API, спочатку потрібно перейти на відповідну сторінку API для покращення обличчя для подачі заявки на відповідну послугу. Після переходу на сторінку натисніть кнопку «Acquire», як показано на малюнку: Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти. Після входу або реєстрації ви автоматично повернетеся на поточну сторінку. При першій подачі заявки вам буде надано безкоштовний ліміт, який дозволяє безкоштовно використовувати цей API.

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

Спочатку потрібно ознайомитися з основним способом використання, а саме, ввести посилання на зображення та інформацію про покращення обличчя, щоб отримати оброблене зображення. Спочатку потрібно просто передати поле image_url, зображення обличчя показано на малюнку нижче:

Далі потрібно завантажити параметри інформації про покращення обличчя, деталі наведені нижче в інформації про запит. Тепер ми можемо заповнити відповідні дані на інтерфейсі, як показано на малюнку:

Можна побачити, що ми налаштували заголовки запиту, включаючи:
  • accept: формат відповіді, який ви хочете отримати, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після подачі заявки ви можете вибрати його зі списку.
Крім того, налаштовано тіло запиту, яке включає:
  • image_url: посилання на зображення обличчя, яке потрібно обробити.
  • smoothing: ступінь згладжування, діапазон значень [0,100]. 0 - без згладжування, 100 - максимальний ступінь. Значення за замовчуванням 10.
  • whitening: ступінь освітлення, діапазон значень [0,100]. 0 - без освітлення, 100 - максимальний ступінь. Значення за замовчуванням 30.
  • face_lifting: ступінь зменшення обличчя, діапазон значень [0,100]. 0 - без зменшення, 100 - максимальний ступінь. Значення за замовчуванням 70.
  • eye_enlarging: ступінь збільшення очей, діапазон значень [0,100]. 0 - без збільшення, 100 - максимальний ступінь. Значення за замовчуванням 70.
Після вибору можна помітити, що праворуч також згенеровано відповідний код, як показано на малюнку:

Натисніть кнопку «Try», щоб провести тестування, як показано на малюнку, тут ми отримали наступний результат: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
Можна побачити, що в повернутому результаті є поле image_url, яке містить зображення обличчя після змін, внесених за допомогою покращення. Змінене зображення обличчя показано нижче:

Можна побачити, що обличчя на зображенні змінилося відповідно до введеної інформації про покращення. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так: 
curl -X POST 'https://api.acedata.cloud/face/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "smoothing": 50,
  "whitening": 50,
  "face_lifting": 50,
  "eye_enlarging": 50
}'
Код інтеграції на Python виглядає так: 
import requests

url = "https://api.acedata.cloud/face/beautify"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "smoothing": 50,
    "whitening": 50,
    "face_lifting": 50,
    "eye_enlarging": 50
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

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

При виклику 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"
}

​
Висновок

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