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 повертає Base64 heatmap, 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 | Base64 heatmap підозрілих областей, повертається коли 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 і координати області
- Створено для workflow перевірки документів і зображень на підробку
- Після покупки endpoint і token доступні в панелі керування
Зростання
Найкраще для продакшен-пілотів і стабільного використання
- Аутентифікація через Bearer token
- Результат підробки, впевненість, heatmap і координати області
- Створено для workflow перевірки документів і зображень на підробку
- Після покупки endpoint і token доступні в панелі керування
Масштаб
Найкраще для пакетних процесів і команд із кількома проєктами
- Аутентифікація через Bearer token
- Результат підробки, впевненість, heatmap і координати області
- Створено для workflow перевірки документів і зображень на підробку
- Після покупки endpoint і token доступні в панелі керування
Бізнес
Найкраще для довгострокових продакшен-навантажень
- Аутентифікація через Bearer token
- Результат підробки, впевненість, heatmap і координати області
- Створено для workflow перевірки документів і зображень на підробку
- Після покупки endpoint і token доступні в панелі керування
Чому розробники довіряють нашому API
Створений для виробничих навантажень, наш API виявлення підробок балансує якість, продуктивність та вартість, щоб ви могли покладатися на нього в реальних додатках.
Готова до продакшену надійність
Висока доступність та стабільна продуктивність, налаштована для реального трафіку.
Оптимізовано для виявлення підробок
Моделі, зосереджені на документах, сертифікатах та рахунках з виявленням маніпуляцій для більш послідовних результатів.
Передбачуване, лише API ціноутворення
Виділені плани API з чіткими витратами на кредит для довгострокових інтеграцій.
Підтримка, коли вона вам потрібна
Підтримка по email, щоб допомогти вам діагностувати проблеми та покращити вашу інтеграцію з часом.
1 API-кредит = 1 API-запит. Ціни API нижчі за разові пакети кредитів, тоді як підписки залишаються найекономічнішим варіантом для постійного використання.