Wykrywanie Fałszerstw Obrazów
API

Wykryj fałszerstwa w dowolnym obrazie za pomocą 1 wywołania API

Przykłady Żądań i Odpowiedzi

Użyj tych przykładów do budowania i debugowania integracji

Przykładowe Żądanie HTTP

POST https://{your-api-domain}/forgery_detection
Nagłówki:
  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"
}

Przykładowe Odpowiedzi

Sukces odpowiedzi

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"
}

Odpowiedź błędu biznesowego

Gdy usługa upstream zgłasza błąd biznesowy, API zwraca błąd = "API_ERROR" i kod różny od zera. Możesz zmapować ten kod używając tabeli kodów błędów poniżej.

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."
}

Wprowadzenie do API

Technologia sztucznej inteligencji specjalizująca się w wykrywaniu fałszerstw została ułatwiona bardziej niż kiedykolwiek dzięki użyciu API ImgAuth.com. Za pomocą zaledwie kilku linii kodu możesz wprowadzić tę technologię do swojej aplikacji.

1

Kup Pakiet

Kup pakiet dedykowany dla API

2

Otrzymaj Email API

W ciągu 2 godzin od zakupu otrzymasz email z dedykowaną domeną API i AppCode.

3

Użyj Przykładów Kodu

Użyj następujących przykładów kodu, aby szybko zacząć

4

Dostosuj Parametry

Wróć do referencji parametrów, aby dostosować żądanie

Uwierzytelnianie

Uwierzytelniamy żądania za pomocą dedykowanej domeny API i tokenu Bearer na konto. Po zakupie pakietu API wyślemy Ci email z unikalną domeną API i tokenem. Ze względów bezpieczeństwa prosimy nie publikować swojego tokenu API.

Punkt Końcowy API

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

Zastąp {your-api-domain} domeną API, którą wysyłamy Ci emailem po zakupie. Każdy deweloper ma dedykowaną domenę i token.

Nagłówki

Autoryzacja:
Bearer {YOUR_API_TOKEN}
Zastąp {YOUR_API_TOKEN} tokenem Bearer, który wysyłamy Ci emailem. Zachowaj go w tajemnicy i nigdy nie commituj go do publicznych repozytoriów.
Content-Type:
application/json; charset=UTF-8

Przykłady Kodu

Zacznij szybko z naszymi przykładami kodu

#!/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"

Parametry Żądania

Skonfiguruj swoje żądania API za pomocą tych parametrów

ParametrTypOpis
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

Kody Błędów

Referencja dla kodów odpowiedzi API

Kod BłęduKomunikat BłęduOpis
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

Plany Cenowe API

Następujące plany są wyłączne dla API

Starter

$99$0.198 / Kredyt
500 kredytów
Ważność 3 miesiące
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Wykrywanie fałszerstw dokumentów
  • Usuwanie wzoru moiré z obrazu
  • Prędkość przetwarzania ~2 sekundy
Najpopularniejsze

Popular

$349$0.07 / Kredyt
5,000 kredytów
Ważność 6 miesięcy
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Wykrywanie fałszerstw dokumentów
  • Usuwanie wzoru moiré z obrazu
  • Prędkość przetwarzania ~2 sekundy

Business

$749$0.05 / Kredyt
15,000 kredytów
Ważność 1 rok
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Wykrywanie fałszerstw dokumentów
  • Usuwanie wzoru moiré z obrazu
  • Prędkość przetwarzania ~2 sekundy
Ekskluzywny

Enterprise

$1999$0.04 / Kredyt
50,000 kredytów
Ważność 1 rok
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Wykrywanie fałszerstw dokumentów
  • Usuwanie wzoru moiré z obrazu
  • Prędkość przetwarzania ~2 sekundy

Dlaczego deweloperzy ufają naszemu API

Zbudowane dla obciążeń produkcyjnych, nasze API wykrywania fałszerstw równoważy jakość, wydajność i koszt, dzięki czemu możesz na nim polegać w rzeczywistych aplikacjach.

Niezawodność gotowa do produkcji

Wysoka dostępność i stabilna wydajność dostosowana do rzeczywistego ruchu.

Zoptymalizowane do wykrywania fałszerstw

Modele skupione na dokumentach, certyfikatach i fakturach z wykrywaniem manipulacji dla bardziej spójnych wyników.

Przewidywalne, wyłącznie ceny API

Dedykowane plany API z jasnymi kosztami na kredyt dla długoterminowych integracji.

Wsparcie, gdy go potrzebujesz

Wsparcie e-mailowe, aby pomóc w diagnozowaniu problemów i poprawie integracji w czasie.

API Wykrywania Fałszerstw Obrazów – Wykryj Manipulację za Pomocą AI