Billedfalsk Detektion
API

Detekter falsk i ethvert billede med 1 API-opkald

Anmodnings- og svar eksempler

Brug disse eksempler til at bygge og fejlfinde din integration

Eksempel HTTP-anmodning

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

Eksempel svar

Vellykket svar

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

Forretningsfejl svar

Når upstream-tjenesten rapporterer en forretningsfejl, returnerer API'en fejl = "API_ERROR" og en ikke-nul kode. Du kan kortlægge denne kode ved hjælp af fejlkodetabellen nedenfor.

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 Introduktion

Kunstig intelligens-teknologien specialiseret i falskdetektering er blevet gjort lettere end nogensinde før ved hjælp af ImgAuth.com API. Med blot et par linjer kode kan du bringe denne teknologi ind i din applikation.

Køb pakke

Køb en pakke dedikeret til API

Modtag API e-mail

Inden for 2 timer efter dit køb modtager du en e-mail med din dedikerede API-domæne og AppCode.

Brug kodeeksempler

Brug følgende kodeeksempler for at komme i gang hurtigt

Juster parametre

Gå tilbage til parameterreferencen for at justere anmodningen

Godkendelse

Vi godkender anmodninger ved hjælp af et dedikeret API-domæne og en Bearer-token pr. konto. Efter du har købt en API-pakke, sender vi dig en e-mail med dit unikke API-domæne og token. Af sikkerhedsmæssige årsager, publicer venligst ikke din API-token.

API Endpoint

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

Erstat {your-api-domain} med API-domænet, vi sender til dig via e-mail efter køb. Hver udvikler har et dedikeret domæne og token.

Headers

Autorisering:

Bearer {YOUR_API_TOKEN}

Erstat {YOUR_API_TOKEN} med Bearer-tokenet, vi sender til dig via e-mail. Hold det hemmeligt og commit det aldrig til offentlige repositories.

Content-Type:

application/json; charset=UTF-8

Kodeeksempler

Kom i gang hurtigt med vores kodeeksempler

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

Anmodningsparametre

Konfigurer dine API-anmodninger med disse parametre

Parameter	Type	Beskrivelse
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

Fejlkoder

Reference for API-svar koder

Fejl kode	Fejl besked	Beskrivelse
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 Prisplaner

Følgende planer er API-eksklusive

Starter

$99$0.198 / Kredit

500 kreditter

3-måneders gyldighed

Understøtter de fleste billedformater
Dokumentkorrektion og forbedring
Dokument falskdetektering
Fjernelse af moiré-mønster fra billede
Behandlingshastighed ~2 sekunder

Mest populære

Business

$749$0.05 / Kredit

15,000 kreditter

1-års gyldighed

Understøtter de fleste billedformater
Dokumentkorrektion og forbedring
Dokument falskdetektering
Fjernelse af moiré-mønster fra billede
Behandlingshastighed ~2 sekunder

Eksklusiv

Enterprise

$1999$0.04 / Kredit

50,000 kreditter

1-års gyldighed

Understøtter de fleste billedformater
Dokumentkorrektion og forbedring
Dokument falskdetektering
Fjernelse af moiré-mønster fra billede
Behandlingshastighed ~2 sekunder

Hvorfor udviklere stoler på vores API

Bygget til produktionsarbejdsbelastninger, balancerer vores falskdetekterings-API kvalitet, ydeevne og omkostninger, så du kan stole på det i virkelige apps.

Produktionsklar pålidelighed

Høj tilgængelighed og stabil ydeevne justeret til reel trafik.

Optimeret til falskdetektering

Modeller fokuseret på dokumenter, certifikater og fakturaer med manipulation detektering for mere konsistente resultater.

Forudsigelig, kun API-prissætning

Dedikerede API-planer med klare pr. kredit omkostninger til langsigtede integrationer.

Support når du har brug for det

E-mail support til at hjælpe dig med at diagnosticere problemer og forbedre din integration over tid.

Vælg API-plan Se refusionspolitik

Billedfalsk DetektionAPI