Обнаружение подделки изображений
API

Обнаружьте подделки в любом изображении с помощью 1 вызова 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"
}

Примеры Ответов

Успешный ответ

When the request is valid and the image is processed successfully, the API returns detection_result indicating whether the image is tampered (fake) or authentic (real), along with optional tampering confidence, heatmap, and location coordinates.

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

Получить Email API

В течение 2 часов после покупки вы получите email с вашим выделенным доменом API и AppCode.

Использовать Примеры Кода

Используйте следующие примеры кода для быстрого старта

Настроить Параметры

Вернитесь к справочнику параметров для настройки запроса

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

Мы аутентифицируем запросы, используя выделенный домен API и токен Bearer для каждой учетной записи. После покупки пакета API мы отправим вам email с вашим уникальным доменом API и токеном. По соображениям безопасности, пожалуйста, не публикуйте ваш токен API.

Конечная точка API

POST https://{your-api-domain}/forgery_detection

Замените {your-api-domain} на домен API, который мы отправим вам по email после покупки. У каждого разработчика есть выделенный домен и токен.

Заголовки

Авторизация:

Bearer {YOUR_API_TOKEN}

Замените {YOUR_API_TOKEN} на токен Bearer, который мы отправим вам по email. Храните его в секрете и никогда не коммитьте в публичные репозитории.

Content-Type:

application/json; charset=UTF-8

Примеры Кода

Быстро начните с наших примеров кода

#!/usr/bin/env bash

set -euo pipefail

# Domain and token for the image processing proxy
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"

# Image file passed as first argument (default: testpaper.jpg)
IMAGE_FILE="${1:-testpaper.jpg}"

if [ ! -f "$IMAGE_FILE" ]; then
  echo "Image file not found: $IMAGE_FILE" >&2
  echo "Usage: $0 path/to/image.jpg" >&2
  exit 1
fi

echo "Encoding image to Base64: $IMAGE_FILE"
# Encode image to Base64 and remove newlines (use -i for BSD base64 on macOS)
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')

echo "Building JSON body..."
read -r -d '' JSON_BODY <<EOF || true
{
  "image": "$BASE64_IMAGE",
  "return_heatmap": "false",
  "detect_proportion": "false",
  "restrict_probability": "0.8"
}
EOF

echo "Calling proxy API..."
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"

echo "Response saved to response.json"

Параметры Запроса

Настройте ваши API-запросы с помощью этих параметров

Параметр	Тип	Описание
image	string	Base64 encoded image data, urlencoded. Size must not exceed 10MB. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required.
url	string	Complete image URL, length not exceeding 1024 bytes. Image size must not exceed 10MB after base64 encoding. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required. Please disable URL hotlink protection.
return_heatmap	string	Whether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return
detect_proportion	string	Whether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return
restrict_probability	string	Threshold for returning forgery region coordinates. Range: 0.1 to 1, supports 1 decimal place. Default: 0.8. When forgery region coordinate confidence score (probability) ≥ threshold, tampered_location returns coordinates meeting the threshold, otherwise does not return coordinates

Response Parameters

Reference for API response fields

Parameter	Type	Description
detection_result	string	Tampering detection result: "fake" indicates tampering detected, "real" indicates no tampering
tampered_proportion	float	Image tampering confidence (returned when detect_proportion = true in request)
heatmap	string	Base64-encoded heatmap of tampered regions (returned when return_heatmap = true in request)
tampered_location	array	Array of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score)
left	uint32	Horizontal coordinate of the top-left vertex of the forgery region
top	uint32	Vertical coordinate of the top-left vertex of the forgery region
width	uint32	Width of the forgery region
height	uint32	Height of the forgery region
probability	float	Confidence score indicating the probability of forgery in this region

Коды Ошибок

Справочник кодов ответов API

Код Ошибки	Сообщение Об Ошибке	Описание
0	success	Success
1000	body error	Request body error
1001	param error	Request parameter error
1002	content type error	Content-Type error
1003	image not exists	Image file not found
1004	image size error	Image size error
1005	image format error	Image format error
1006	invalid signature	Invalid signature
1007	body size error	Body size error
1008	no authorization	Authorization failed
2000	server unknown error	Server unknown error
2001	server timeout	Server timeout
2003	no content recognition	No content recognized
2004	validate data error	Validation data error
3000	remote server error	Remote server error
4000	base server error	Base server error

Тарифные Планы API

Следующие планы предназначены исключительно для API

Starter

$99$0.198 / Кредит

500 кредитов

Срок действия 3 месяца

Поддерживает большинство форматов изображений
Коррекция и улучшение документов
Обнаружение подделок документов
Удаление муарового узора с изображения
Скорость обработки ~2 секунды

Самый Популярный

Поддерживает большинство форматов изображений
Коррекция и улучшение документов
Обнаружение подделок документов
Удаление муарового узора с изображения
Скорость обработки ~2 секунды

Business

$749$0.05 / Кредит

15,000 кредитов

Срок действия 1 год

Поддерживает большинство форматов изображений
Коррекция и улучшение документов
Обнаружение подделок документов
Удаление муарового узора с изображения
Скорость обработки ~2 секунды

Эксклюзивный

Enterprise

$1999$0.04 / Кредит

50,000 кредитов

Срок действия 1 год

Поддерживает большинство форматов изображений
Коррекция и улучшение документов
Обнаружение подделок документов
Удаление муарового узора с изображения
Скорость обработки ~2 секунды

Почему разработчики доверяют нашему API

Созданный для производственных рабочих нагрузок, наш API обнаружения подделок балансирует качество, производительность и стоимость, чтобы вы могли полагаться на него в реальных приложениях.

Готовая к продакшену надежность

Высокая доступность и стабильная производительность, настроенная для реального трафика.

Оптимизирован для обнаружения подделок

Модели, сфокусированные на документах, сертификатах и счетах с обнаружением манипуляций для более последовательных результатов.

Предсказуемое, только API ценообразование

Выделенные планы API с четкими затратами на кредит для долгосрочных интеграций.

Поддержка, когда она вам нужна

Поддержка по email, чтобы помочь вам диагностировать проблемы и улучшить вашу интеграцию со временем.

Выбрать План API Посмотреть Политику Возврата

Обнаружение подделки изображенийAPI