Справжнє або ШІ-обличчя API

Вступ до API

Перевірте, чи виглядає обличчя справжнім або створеним ШІ, включно з ознаками синтетичних облич, ШІ-заміни обличчя та сильного ретушування за допомогою ШІ. Модель аналізує все зображення й повертає оцінку ризику ШІ-генерації.

Параметри Запиту: Підтримувані портретні файли до 10 МБ.
Параметри відповіді: Що вища оцінка, то сильніші ознаки ШІ-генерації на всьому зображенні. Використовуйте її як сигнал для перевірки, а не як доказ, що зображення справжнє.

Вступ до API

Перевірка, чи фото профілю виглядає справжнім або створеним ШІ
Перевірка селфі та портретів на ознаки синтетичних облич
Виявлення можливої ШІ-заміни обличчя або сильного ретушування за допомогою ШІ

Аутентифікація

Замініть {your-api-domain} на endpoint API, показаний на панелі акаунта.

Автентифікуйте запити за допомогою endpoint API вашого акаунта та Bearer-токена. Після покупки API-кредитів ви можете переглянути endpoint і токен на панелі акаунта. Зберігайте токен у таємниці та ніколи не публікуйте його у відкритих репозиторіях.

POSThttps://api.imgauth.com/v1/real-or-ai-face

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

Параметри Запиту

Параметр	Тип	✓	Опис
image	string	✓	Підтримувані портретні файли до 10 МБ.

Приклад HTTP Запиту

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

Параметри відповіді

Параметр	Тип	Опис
code	integer	Довідник кодів відповідей API
request_id	string	Використайте ці приклади для створення та налагодження вашої інтеграції
data.ai_generated	boolean \| null	Ймовірно, зображення обличчя створене або суттєво змінене ШІ / Сильних ознак генерації ШІ не виявлено
data.ai_generation_score	number \| null	Що вища оцінка, то сильніші ознаки ШІ-генерації на всьому зображенні. Використовуйте її як сигнал для перевірки, а не як доказ, що зображення справжнє.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	Рекомендована перевірка
data.analysis_scope	"portrait"	Перевірте, чи виглядає обличчя справжнім або створеним ШІ, включно з ознаками синтетичних облич, ШІ-заміни обличчя та сильного ретушування за допомогою ШІ. Модель аналізує все зображення й повертає оцінку ризику ШІ-генерації.

Приклади Відповідей

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "ai_generated": true,
    "ai_generation_score": 0.89,
    "review_status": "likely_ai",
    "analysis_scope": "portrait"
  }
}

Коди Помилок

400INVALID_REQUESTAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

401INVALID_API_KEYAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

402CREDITS_EXHAUSTEDAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

413PAYLOAD_TOO_LARGEAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

415UNSUPPORTED_IMAGEAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

502UPSTREAM_ERRORAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

504UPSTREAM_TIMEOUTAPI messages відображаються як сирі значення upstream-сервісу, щоб точно збігатися з відповідями у продакшені.

Приклади Коду

curl -X POST "https://api.imgauth.com/v1/real-or-ai-face" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}'