Виявлення підробки зображень
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. Лише кількома рядками коду ви можете внедрити цю технологію у своє застосування.

1

Купити Пакет

Купити пакет, призначений для API

2

Отримати Email API

Протягом 2 годин після покупки ви отримаєте email з вашим виділеним доменом API та AppCode.

3

Використати Приклади Коду

Використайте наступні приклади коду для швидкого старту

4

Налаштувати Параметри

Поверніться до довідника параметрів для налаштування запиту

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

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

Кінцева точка API

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

Замініть {your-api-domain} на домен API, який ми надішлемо вам електронною поштою після покупки. Кожен розробник має виділений домен та токен.

Заголовки

Авторизація:
Bearer {YOUR_API_TOKEN}
Замініть {YOUR_API_TOKEN} на токен Bearer, який ми надішлемо вам електронною поштою. Зберігайте його в секреті та ніколи не комітьте його в публічні репозиторії.
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-запити за допомогою цих параметрів

ПараметрТипОпис
imagestringBase64 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.
urlstringComplete 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_heatmapstringWhether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return
detect_proportionstringWhether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return
restrict_probabilitystringThreshold 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

ParameterTypeDescription
detection_resultstringTampering detection result: "fake" indicates tampering detected, "real" indicates no tampering
tampered_proportionfloatImage tampering confidence (returned when detect_proportion = true in request)
heatmapstringBase64-encoded heatmap of tampered regions (returned when return_heatmap = true in request)
tampered_locationarrayArray of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score)
leftuint32Horizontal coordinate of the top-left vertex of the forgery region
topuint32Vertical coordinate of the top-left vertex of the forgery region
widthuint32Width of the forgery region
heightuint32Height of the forgery region
probabilityfloatConfidence score indicating the probability of forgery in this region

Коди Помилок

Довідник кодів відповідей API

Код ПомилкиПовідомлення про ПомилкуОпис
0successSuccess
1000body errorRequest body error
1001param errorRequest parameter error
1002content type errorContent-Type error
1003image not existsImage file not found
1004image size errorImage size error
1005image format errorImage format error
1006invalid signatureInvalid signature
1007body size errorBody size error
1008no authorizationAuthorization failed
2000server unknown errorServer unknown error
2001server timeoutServer timeout
2003no content recognitionNo content recognized
2004validate data errorValidation data error
3000remote server errorRemote server error
4000base server errorBase server error

Тарифні Плани API

Наступні плани призначені виключно для API

Starter

$99$0.198 / Кредит
500 кредитів
Термін дії 3 місяці
  • Підтримує більшість форматів зображень
  • Корекція та покращення документів
  • Виявлення підробок документів
  • Видалення муарового візерунка зі зображення
  • Швидкість обробки ~2 секунди
Найпопулярніший

Popular

$349$0.07 / Кредит
5,000 кредитів
Термін дії 6 місяців
  • Підтримує більшість форматів зображень
  • Корекція та покращення документів
  • Виявлення підробок документів
  • Видалення муарового візерунка зі зображення
  • Швидкість обробки ~2 секунди

Business

$749$0.05 / Кредит
15,000 кредитів
Термін дії 1 рік
  • Підтримує більшість форматів зображень
  • Корекція та покращення документів
  • Виявлення підробок документів
  • Видалення муарового візерунка зі зображення
  • Швидкість обробки ~2 секунди
Ексклюзивний

Enterprise

$1999$0.04 / Кредит
50,000 кредитів
Термін дії 1 рік
  • Підтримує більшість форматів зображень
  • Корекція та покращення документів
  • Виявлення підробок документів
  • Видалення муарового візерунка зі зображення
  • Швидкість обробки ~2 секунди

Чому розробники довіряють нашому API

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

Готова до продакшену надійність

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

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

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

Передбачуване, лише API ціноутворення

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

Підтримка, коли вона вам потрібна

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

API Виявлення Підробок Зображень – Виявіть Маніпуляції з AI