API för Bildförfalskningsdetektering
Utvecklaråtkomst

Upptäck manipulering av dokument och bilder med ett produktionsklart REST API.

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

När begäran är giltig och bilden behandlas framgångsrikt returnerar API:t detection_result för att visa om bilden är manipulerad (fake) eller äkta (real), tillsammans med tillförlitlighet, heatmap och koordinater när de efterfrågas.

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.

1

Välj API-krediter

Välj det API-kreditpaket som passar din integrationsvolym

2

Få API-åtkomst

Efter köp kan du se din API-nyckel och endpoint i ditt kontopanel

3

Använd Kodexempel

Använd följande kodexempel för att komma igång snabbt

4

Gå live

Övervaka användningen, justera parametrar och gå till produktion

Autentisering

Autentisera förfrågningar med ditt kontos API-endpoint och en Bearer-token. Efter att du köpt API-krediter kan du se endpoint och token i ditt kontopanel. Håll din token hemlig och lägg den aldrig i publika repositorier.

API Slutpunkt

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

Ersätt {your-api-domain} med API-endpointen som visas i ditt kontopanel.

Rubriker

Auktorisering:
Bearer {YOUR_API_TOKEN}
Ersätt {YOUR_API_TOKEN} med Bearer-token som visas i ditt kontopanel. Håll den hemlig och lägg den aldrig i publika repositorier.
Content-Type:
application/json; charset=UTF-8

Kodexempel

Kom igång snabbt med våra kodexempel

#!/usr/bin/env bash

set -euo pipefail

API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"
IMAGE_FILE="${1:-testpaper.jpg}"

BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')

read -r -d '' JSON_BODY <<EOF || true
{
  "image": "$BASE64_IMAGE",
  "return_heatmap": "false",
  "detect_proportion": "false",
  "restrict_probability": "0.8"
}
EOF

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"

Begäran Parametrar

Konfigurera dina API-begäranden med dessa parametrar

ParameterTypBeskrivning
imagestringBase64-kodad bilddata som sedan URL-kodas. Max 10 MB. Kortaste sidan minst 512 px och längsta sidan högst 8192 px. Stöder jpg/jpeg/png/bmp. Ange image eller url.
urlstringFullständig bild-URL på högst 1024 byte. Den kodade bilden måste vara under 10 MB. Kortaste sidan minst 512 px och längsta sidan högst 8192 px. Stöder jpg/jpeg/png/bmp. Ange image eller url och stäng av hotlink-skydd.
return_heatmapstringAnger om ett förfalsknings-heatmap ska returneras. Standard: false. true returnerar ett Base64-heatmap, false gör det inte.
detect_proportionstringAnger om tillförlitlighetspoängen för manipulering ska returneras. Standard: false. true returnerar poängen, false gör det inte.
restrict_probabilitystringTröskel för att returnera förfalskningskoordinater. Intervall: 0.1 till 1 med 1 decimal. Standard: 0.8. tampered_location returneras bara när probability når eller överstiger tröskeln.

Svarparametrar

Referens för API-svarsfält

ParameterTypBeskrivning
detection_resultstringManipuleringsresultat: "fake" betyder att manipulering upptäcktes och "real" betyder att ingen manipulering upptäcktes.
tampered_proportionfloatTillförlitlighetspoäng för manipulering, returneras när detect_proportion = true.
heatmapstringBase64-heatmap för manipulerade områden, returneras när return_heatmap = true.
tampered_locationarrayArray med koordinater för misstänkta områden, returneras när probability är större än eller lika med restrict_probability. Varje post innehåller left, top, width, height och probability.
leftuint32Horisontell koordinat för det misstänkta områdets övre vänstra hörn.
topuint32Vertikal koordinat för det misstänkta områdets övre vänstra hörn.
widthuint32Bredden på det misstänkta området.
heightuint32Höjden på det misstänkta området.
probabilityfloatTillförlitlighetspoäng för detta misstänkta område.

Felkoder

Referens för API-svarkoder

FelkodFelmeddelande
0success
1000body error
1001param error
1002content type error
1003image not exists
1004image size error
1005image format error
1006invalid signature
1007body size error
1008no authorization
2000server unknown error
2001server timeout
2003no content recognition
2004validate data error
3000remote server error
4000base server error

API messages visas som råa upstream-värden så att de exakt matchar svaren i produktion.

API Prisplaner

Billigare än engångspaket med krediter. Prenumerationer är fortfarande det billigaste alternativet för återkommande användning.

Utvecklare

$99
500 krediter
giltigt i 12 månader

Bäst för utvärdering och tidig integration

  • Autentisering med Bearer token
  • Förfalskningsresultat, tillförlitlighet, heatmap och regionskoordinater
  • Byggt för arbetsflöden som granskar manipulerade dokument och bilder
  • Åtkomst till endpoint och token i kontrollpanelen efter köp
Mest populär

Tillväxt

$359
2,000 krediter
giltigt i 12 månader

Bäst för produktionspiloter och stabil användning

  • Autentisering med Bearer token
  • Förfalskningsresultat, tillförlitlighet, heatmap och regionskoordinater
  • Byggt för arbetsflöden som granskar manipulerade dokument och bilder
  • Åtkomst till endpoint och token i kontrollpanelen efter köp

Skala

$899
5,000 krediter
giltigt i 12 månader

Bäst för batcharbetsflöden och team med flera projekt

  • Autentisering med Bearer token
  • Förfalskningsresultat, tillförlitlighet, heatmap och regionskoordinater
  • Byggt för arbetsflöden som granskar manipulerade dokument och bilder
  • Åtkomst till endpoint och token i kontrollpanelen efter köp
Bäst värde

Företag

$2,499
15,000 krediter
giltigt i 12 månader

Bäst för långsiktiga produktionsarbetsbelastningar

  • Autentisering med Bearer token
  • Förfalskningsresultat, tillförlitlighet, heatmap och regionskoordinater
  • Byggt för arbetsflöden som granskar manipulerade dokument och bilder
  • Åtkomst till endpoint och token i kontrollpanelen efter köp

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.

1 API-kredit = 1 API-begäran. API-prissättningen är lägre än engångspaket med krediter, medan prenumerationer fortfarande är det mest ekonomiska valet för kontinuerlig användning.