Forespørsel- og Svar Eksempler
Bruk disse eksemplene for å bygge og feilsøke integrasjonen din
Eksempel HTTP Forespørsel
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"
}Forretningsfeil svar
Når upstream-tjenesten rapporterer en forretningsfeil, returnerer API-en feil = "API_ERROR" og en ikke-null kode. Du kan kartlegge denne koden ved å bruke feilkodetabellen 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 Introduksjon
Kunstig intelligens-teknologien spesialisert i falskdeteksjon har blitt gjort enklere enn noen gang ved å bruke ImgAuth.com API. Med bare noen få linjer med kode kan du bringe denne teknologien inn i applikasjonen din.
Kjøp Pakke
Kjøp en pakke dedikert til API
Motta API E-post
Innen 2 timer etter kjøpet ditt vil du motta en e-post med ditt dedikerte API-domene og AppCode.
Bruk Kodeeksempler
Bruk følgende kodeeksempler for å komme i gang raskt
Juster Parametere
Gå tilbake til parameterreferansen for å justere forespørselen
Autentisering
Vi autentiserer forespørsler ved å bruke et dedikert API-domene og en Bearer-token per konto. Etter at du har kjøpt en API-pakke, sender vi deg en e-post med ditt unike API-domene og token. Av sikkerhetshensyn, vennligst ikke publiser API-tokenet ditt.
API Endepunkt
Erstatt {your-api-domain} med API-domenet vi sender deg via e-post etter kjøp. Hver utvikler har et dedikert domene og token.
Headers
Kodeeksempler
Kom i gang raskt med våre 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"Forespørsel Parametere
Konfigurer API-forespørslene dine med disse parameterne
| 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 |
Feilkoder
Referanse for API-svar koder
| Feil Kode | Feil Melding | 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
- Støtter de fleste bildeformater
- Dokumentkorreksjon og forbedring
- Dokument falskdeteksjon
- Fjerning av moiré-mønster fra bilde
- Behandlingshastighet ~2 sekunder
Popular
- Støtter de fleste bildeformater
- Dokumentkorreksjon og forbedring
- Dokument falskdeteksjon
- Fjerning av moiré-mønster fra bilde
- Behandlingshastighet ~2 sekunder
Business
- Støtter de fleste bildeformater
- Dokumentkorreksjon og forbedring
- Dokument falskdeteksjon
- Fjerning av moiré-mønster fra bilde
- Behandlingshastighet ~2 sekunder
Enterprise
- Støtter de fleste bildeformater
- Dokumentkorreksjon og forbedring
- Dokument falskdeteksjon
- Fjerning av moiré-mønster fra bilde
- Behandlingshastighet ~2 sekunder
Hvorfor utviklere stoler på vår API
Bygget for produksjonsarbeidsbelastninger, balanserer vår falskdeteksjons-API kvalitet, ytelse og kostnad slik at du kan stole på den i virkelige apper.
Produksjonsklar pålitelighet
Høy tilgjengelighet og stabil ytelse justert for ekte trafikk.
Optimalisert for falskdeteksjon
Modeller fokusert på dokumenter, sertifikater og fakturaer med manipulasjonsdeteksjon for mer konsistente resultater.
Forutsigbar, kun API-prising
Dedikerte API-planer med klare pr. kredit kostnader for langsiktige integrasjoner.
Støtte når du trenger det
E-poststøtte for å hjelpe deg med å diagnostisere problemer og forbedre integrasjonen din over tid.