Настоящее или ИИ-лицо 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>"
}'