Detekce Falšování Obrázků
API

Detekujte padělky v jakémkoli obrázku pomocí 1 volání API

Příklady požadavků a odpovědí

Použijte tyto příklady k vytvoření a ladění vaší integrace

Ukázkový HTTP požadavek

POST https://{your-api-domain}/forgery_detection
Hlavičky:
  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"
}

Ukázkové odpovědi

Úspěšná odpověď

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

Odpověď na obchodní chybu

Když nadřazená služba hlásí obchodní chybu, API vrátí chybu = "API_ERROR" a nenulový kód. Tento kód můžete mapovat pomocí tabulky chybových kódů níže.

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

Úvod do API

Technologie umělé inteligence specializovaná na detekci padělků byla díky API ImgAuth.com usnadněna více než kdy dříve. Pouhými několika řádky kódu můžete tuto technologii přinést do své aplikace.

1

Zakoupit balíček

Zakoupit balíček věnovaný API

2

Přijmout API e-mail

Do 2 hodin po zakoupení obdržíte e-mail s vaší vyhrazenou API doménou a AppCode.

3

Použít ukázky kódu

Použijte následující ukázky kódu pro rychlý start

4

Upravit parametry

Vraťte se k referenci parametrů pro úpravu požadavku

Ověření

Ověřujeme požadavky pomocí vyhrazené API domény a Bearer tokenu na účet. Po zakoupení API balíčku vám zašleme e-mail s vaší jedinečnou API doménou a tokenem. Z bezpečnostních důvodů prosím nezveřejňujte svůj API token.

API koncový bod

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

Nahraďte {your-api-domain} API doménou, kterou vám zašleme e-mailem po zakoupení. Každý vývojář má vyhrazenou doménu a token.

Hlavičky

Autorizace:
Bearer {YOUR_API_TOKEN}
Nahraďte {YOUR_API_TOKEN} Bearer tokenem, který vám zašleme e-mailem. Uchovávejte ho v tajnosti a nikdy ho neukládejte do veřejných repozitářů.
Content-Type:
application/json; charset=UTF-8

Příklady kódu

Začněte rychle s našimi ukázkami kódu

#!/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 požadavku

Nakonfigurujte své API požadavky pomocí těchto parametrů

ParametrTypPopis
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

Chybové kódy

Referenční příručka pro kódy odpovědí API

Chybový kódChybová zprávaPopis
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

Cenové plány API

Následující plány jsou výhradně pro API

Starter

$99$0.198 / Kredit
500 kreditů
3měsíční platnost
  • Podpora většiny formátů obrázků
  • Oprava a vylepšení dokumentů
  • Detekce padělků dokumentů
  • Odstranění vzoru moaré z obrázku
  • Rychlost zpracování ~2 sekundy
Nejpopulárnější

Popular

$349$0.07 / Kredit
5,000 kreditů
6měsíční platnost
  • Podpora většiny formátů obrázků
  • Oprava a vylepšení dokumentů
  • Detekce padělků dokumentů
  • Odstranění vzoru moaré z obrázku
  • Rychlost zpracování ~2 sekundy

Business

$749$0.05 / Kredit
15,000 kreditů
1letá platnost
  • Podpora většiny formátů obrázků
  • Oprava a vylepšení dokumentů
  • Detekce padělků dokumentů
  • Odstranění vzoru moaré z obrázku
  • Rychlost zpracování ~2 sekundy
Exkluzivní

Enterprise

$1999$0.04 / Kredit
50,000 kreditů
1letá platnost
  • Podpora většiny formátů obrázků
  • Oprava a vylepšení dokumentů
  • Detekce padělků dokumentů
  • Odstranění vzoru moaré z obrázku
  • Rychlost zpracování ~2 sekundy

Proč vývojáři důvěřují našemu API

Vytvořené pro produkční zátěž, naše API pro detekci padělků vyvažuje kvalitu, výkon a náklady, takže se na něj můžete spolehnout v reálných aplikacích.

Produkčně připravená spolehlivost

Vysoká dostupnost a stabilní výkon optimalizovaný pro reálný provoz.

Optimalizováno pro detekci padělků

Modely zaměřené na dokumenty, certifikáty a faktury s detekcí manipulace pro konzistentnější výsledky.

Předvídatelné, pouze API cenění

Vyhrazené API plány s jasnými náklady na kredit pro dlouhodobé integrace.

Podpora, když ji potřebujete

E-mailová podpora, která vám pomůže diagnostikovat problémy a v průběhu času zlepšit vaši integraci.

API pro detekci padělků obrázků – Detekujte manipulaci pomocí AI