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

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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

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

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

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

Як видно, ми налаштували заголовки запиту, включаючи:
  • accept: вказує, в якому форматі ви хочете отримати відповідь, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після подачі заявки можна вибрати з випадаючого списку.
Також налаштовано тіло запиту, яке включає:
  • image_url: посилання на зображення обличчя, яке потрібно обробити.
  • age_infos: інформація про вік обличчя та регіон, де вік є обов’язковим параметром.
Після вибору можна помітити, що праворуч також згенеровано відповідний код, як показано на малюнку:

Натисніть кнопку «Try», щоб провести тестування, як показано на малюнку, і ми отримали наступний результат: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/ChangeAgePic/1256437459/bfce1ab8-5fd7-464d-8878-b38433f84d0e"
}
Як видно, у повернутому результаті є поле image_url, яке містить зображення обличчя після зміни віку. Зміна обличчя виглядає наступним чином:

Як видно, обличчя на зображенні змінилося відповідно до введеного віку. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так: 
curl -X POST 'https://api.xhuoapi.ai/v1/face/change-age' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "age_infos": [{"age":60}],
  "image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}'
Код інтеграції на Python виглядає так: 
import requests

url = "https://api.xhuoapi.ai/v1/face/change-age"

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

payload = {
    "age_infos": [{"age":60}],
    "image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}

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. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.