Bildförfalskningsdetektering
API
Upptäck förfalskningar i vilken bild som helst med 1 API-anrop
Begäran och Svar Exempel
Använd dessa exempel för att bygga och felsöka din integration
Exempel HTTP Begäran
POST https://{your-api-domain}/forgery_detection
Rubriker:
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"
}Exempel Svar
Framgångsrikt 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"
}Affärsfel svar
När upstream-tjänsten rapporterar ett affärsfel returnerar API:et fel = "API_ERROR" och en icke-noll kod. Du kan mappa denna kod med hjälp av felkodstabellen nedan.
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
Artificiell intelligens-teknologin specialiserad på bildförfalskningsdetektering har gjorts enklare än någonsin med hjälp av ImgAuth.com API. Med bara några rader kod kan du ta med denna teknik i din applikation.
Köp Paket
Köp ett paket dedikerat till API
Ta Emot API E-post
Inom 2 timmar efter ditt köp kommer du att få ett e-postmeddelande med ditt dedikerade API-domän och AppCode.
Använd Kodexempel
Använd följande kodexempel för att komma igång snabbt
Justera Parametrar
Gå tillbaka till parameterreferensen för att justera begäran
Autentisering
Vi autentiserar begäranden med hjälp av en dedikerad API-domän och en Bearer-token per konto. Efter att du har köpt ett API-paket skickar vi dig ett e-postmeddelande med din unika API-domän och token. Av säkerhetsskäl, publicera inte din API-token.
API Slutpunkt
Ersätt {your-api-domain} med API-domänen vi skickar till dig via e-post efter köp. Varje utvecklare har en dedikerad domän och token.
Rubriker
Kodexempel
Kom igång snabbt med våra kodexempel
#!/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"Begäran Parametrar
Konfigurera dina API-begäranden med dessa parametrar
| Parameter | Typ | Beskrivning |
|---|---|---|
| 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 |
Felkoder
Referens för API-svarkoder
| Felkod | Felmeddelande | Beskrivning |
|---|---|---|
| 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öljande planer är API-exklusiva
Starter
- Stöder de flesta bildformat
- Dokumentkorrigering och förbättring
- Dokumentförfalskningsdetektering
- Borttagning av moiré-mönster från bild
- Bearbetningshastighet ~2 sekunder
Popular
- Stöder de flesta bildformat
- Dokumentkorrigering och förbättring
- Dokumentförfalskningsdetektering
- Borttagning av moiré-mönster från bild
- Bearbetningshastighet ~2 sekunder
Business
- Stöder de flesta bildformat
- Dokumentkorrigering och förbättring
- Dokumentförfalskningsdetektering
- Borttagning av moiré-mönster från bild
- Bearbetningshastighet ~2 sekunder
Enterprise
- Stöder de flesta bildformat
- Dokumentkorrigering och förbättring
- Dokumentförfalskningsdetektering
- Borttagning av moiré-mönster från bild
- Bearbetningshastighet ~2 sekunder
Varför utvecklare litar på vår API
Byggd för produktionsarbetsbelastningar, balanserar vår förfalskningsdetekterings-API kvalitet, prestanda och kostnad så att du kan lita på den i verkliga appar.
Produktionsklar tillförlitlighet
Hög tillgänglighet och stabil prestanda justerad för verklig trafik.
Optimerad för förfalskningsdetektering
Modeller fokuserade på dokument, certifikat och fakturor med manipulationsdetektering för mer konsekventa resultat.
Förutsägbar, endast API-prissättning
Dedikerade API-planer med tydliga kostnader per kredit för långsiktiga integrationer.
Support när du behöver det
E-poststöd för att hjälpa dig diagnostisera problem och förbättra din integration över tid.