API для обнаружения подделки изображений
Доступ для разработчиков
Определяйте подделку документов и изображений с помощью REST API, готового к продакшену.
Примеры Запроса и Ответа
Используйте эти примеры для создания и отладки вашей интеграции
Пример HTTP Запроса
POST https://{your-api-domain}/forgery_detection
Заголовки:
Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8
Body:
{
"image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}Примеры Ответов
Успешный ответ
Когда запрос корректен и изображение успешно обработано, API возвращает detection_result, чтобы показать, является ли изображение поддельным (fake) или подлинным (real), а также при необходимости уверенность, heatmap и координаты.
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"code": 0,
"data": {
"detection_result": "fake",
"tampered_proportion": 0.000587,
"heatmap": "<BASE64_HEATMAP_IMAGE>",
"tampered_location": [
{
"left": 100,
"top": 200,
"width": 150,
"height": 100,
"probability": 0.95
}
]
},
"message": "Success"
}Ответ бизнес-ошибки
Когда вышестоящий сервис сообщает о бизнес-ошибке, API возвращает ошибку = "API_ERROR" и ненулевой код. Вы можете сопоставить этот код, используя таблицу кодов ошибок ниже.
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8
{
"error": "API_ERROR",
"code": 1004,
"message": "Image size error. Please ensure the image is less than 5MB and the longest side is less than 4000px."
}Введение в API
Технология искусственного интеллекта, специализирующаяся на обнаружении подделки изображений, стала проще, чем когда-либо, с использованием API ImgAuth.com. Всего несколькими строками кода вы можете внедрить эту технологию в свое приложение.
Выберите API-кредиты
Выберите пакет API-кредитов под ваш объём интеграции
Получите доступ к API
После покупки вы сможете увидеть API-ключ и endpoint в панели аккаунта
Использовать Примеры Кода
Используйте следующие примеры кода для быстрого старта
Запуск в продакшен
Отслеживайте использование, настраивайте параметры и переходите в продакшен
Аутентификация
Аутентифицируйте запросы с помощью endpoint API вашего аккаунта и Bearer-токена. После покупки API-кредитов вы сможете увидеть endpoint и токен в панели аккаунта. Храните токен в секрете и никогда не публикуйте его в открытых репозиториях.
Конечная точка API
Замените {your-api-domain} на endpoint API, указанный в панели аккаунта.
Заголовки
Примеры Кода
Быстро начните с наших примеров кода
#!/usr/bin/env bash
set -euo pipefail
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"
IMAGE_FILE="${1:-testpaper.jpg}"
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')
read -r -d '' JSON_BODY <<EOF || true
{
"image": "$BASE64_IMAGE",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}
EOF
curl -X POST "${API_DOMAIN}${API_PATH}" \
-H "Authorization: Bearer ${API_TOKEN}" \
-H "Content-Type: application/json; charset=UTF-8" \
-d "$JSON_BODY" \
-o response.json \
-s -w "\nHTTP status: %{http_code}\n"Параметры Запроса
Настройте ваши API-запросы с помощью этих параметров
| Параметр | Тип | Описание |
|---|---|---|
| image | string | Данные изображения в Base64 с последующим URL-кодированием. Максимум 10 MB. Короткая сторона не менее 512 px, длинная сторона не более 8192 px. Поддерживаются jpg/jpeg/png/bmp. Передайте image или url. |
| url | string | Полный URL изображения длиной до 1024 байт. Размер закодированного изображения должен быть меньше 10 MB. Короткая сторона не менее 512 px, длинная сторона не более 8192 px. Поддерживаются jpg/jpeg/png/bmp. Передайте image или url и отключите защиту от hotlink. |
| return_heatmap | string | Нужно ли возвращать heatmap подделки. По умолчанию false. true возвращает heatmap в Base64, false — нет. |
| detect_proportion | string | Нужно ли возвращать уровень уверенности в подделке. По умолчанию false. true возвращает значение, false — нет. |
| restrict_probability | string | Порог для возврата координат подделки. Диапазон: от 0.1 до 1 с одной цифрой после запятой. По умолчанию 0.8. tampered_location возвращается только если probability достигает или превышает порог. |
Параметры ответа
Справочник полей ответа API
| Параметр | Тип | Описание |
|---|---|---|
| detection_result | string | Результат проверки: "fake" означает, что подделка обнаружена, "real" — что подделка не обнаружена. |
| tampered_proportion | float | Уровень уверенности в подделке, возвращается при detect_proportion = true. |
| heatmap | string | Heatmap в Base64 для поддельных областей, возвращается при return_heatmap = true. |
| tampered_location | array | Массив координат подозрительных областей, возвращается когда probability больше или равна restrict_probability. Каждый элемент содержит left, top, width, height и probability. |
| left | uint32 | Горизонтальная координата верхнего левого угла подозрительной области. |
| top | uint32 | Вертикальная координата верхнего левого угла подозрительной области. |
| width | uint32 | Ширина подозрительной области. |
| height | uint32 | Высота подозрительной области. |
| probability | float | Оценка уверенности для этой подозрительной области. |
Коды Ошибок
Справочник кодов ответов API
| Код Ошибки | Сообщение Об Ошибке |
|---|---|
| 0 | success |
| 1000 | body error |
| 1001 | param error |
| 1002 | content type error |
| 1003 | image not exists |
| 1004 | image size error |
| 1005 | image format error |
| 1006 | invalid signature |
| 1007 | body size error |
| 1008 | no authorization |
| 2000 | server unknown error |
| 2001 | server timeout |
| 2003 | no content recognition |
| 2004 | validate data error |
| 3000 | remote server error |
| 4000 | base server error |
API messages показываются как сырые значения upstream-сервиса, чтобы полностью совпадать с ответами в продакшене.
Тарифные Планы API
Дешевле, чем разовые пакеты кредитов. Подписки остаются самым выгодным вариантом для регулярного использования.
Разработчик
Лучше всего для оценки и ранней интеграции
- Аутентификация по Bearer token
- Результат подделки, уверенность, heatmap и координаты области
- Подходит для процессов проверки документов и изображений на подделку
- После покупки endpoint и token доступны в панели управления
Рост
Лучше всего для продакшен-пилотов и стабильного использования
- Аутентификация по Bearer token
- Результат подделки, уверенность, heatmap и координаты области
- Подходит для процессов проверки документов и изображений на подделку
- После покупки endpoint и token доступны в панели управления
Масштаб
Лучше всего для пакетных процессов и команд с несколькими проектами
- Аутентификация по Bearer token
- Результат подделки, уверенность, heatmap и координаты области
- Подходит для процессов проверки документов и изображений на подделку
- После покупки endpoint и token доступны в панели управления
Бизнес
Лучше всего для долгосрочных продакшен-нагрузок
- Аутентификация по Bearer token
- Результат подделки, уверенность, heatmap и координаты области
- Подходит для процессов проверки документов и изображений на подделку
- После покупки endpoint и token доступны в панели управления
Почему разработчики доверяют нашему API
Созданный для производственных рабочих нагрузок, наш API обнаружения подделок балансирует качество, производительность и стоимость, чтобы вы могли полагаться на него в реальных приложениях.
Готовая к продакшену надежность
Высокая доступность и стабильная производительность, настроенная для реального трафика.
Оптимизирован для обнаружения подделок
Модели, сфокусированные на документах, сертификатах и счетах с обнаружением манипуляций для более последовательных результатов.
Предсказуемое, только API ценообразование
Выделенные планы API с четкими затратами на кредит для долгосрочных интеграций.
Поддержка, когда она вам нужна
Поддержка по email, чтобы помочь вам диагностировать проблемы и улучшить вашу интеграцию со временем.
1 API-кредит = 1 API-запрос. Цена API ниже, чем у разовых пакетов кредитов, а подписки остаются самым экономичным вариантом для постоянного использования.