API for Bildektsforfalskningsdeteksjon
Utviklertilgang

Oppdag manipulering av dokumenter og bilder med et produksjonsklart REST API.

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

Når forespørselen er gyldig og bildet behandles vellykket, returnerer API-en detection_result for å vise om bildet er manipulert (fake) eller ekte (real), sammen med konfidens, heatmap og koordinater når de er forespurt.

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.

1

Velg API-kreditter

Velg API-kredittpakken som passer til integrasjonsvolumet ditt

2

Få API-tilgang

Etter kjøp kan du se API-nøkkelen og endepunktet i kontodashboardet

3

Bruk Kodeeksempler

Bruk følgende kodeeksempler for å komme i gang raskt

4

Gå live

Overvåk bruk, juster parametere og gå til produksjon

Autentisering

Autentiser forespørsler med kontoens API-endepunkt og et Bearer-token. Etter kjøp av API-kreditter kan du se endepunktet og tokenet i kontodashboardet. Hold tokenet hemmelig og ikke commit det til offentlige repositorier.

API Endepunkt

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

Bytt ut {your-api-domain} med API-endepunktet som vises i kontodashboardet.

Headers

Autorisasjon:
Bearer {YOUR_API_TOKEN}
Bytt ut {YOUR_API_TOKEN} med Bearer-tokenet som vises i kontodashboardet. Hold det hemmelig og ikke commit det til offentlige repositorier.
Content-Type:
application/json; charset=UTF-8

Kodeeksempler

Kom i gang raskt med våre kodeeksempler

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

Forespørsel Parametere

Konfigurer API-forespørslene dine med disse parameterne

ParameterTypeBeskrivelse
imagestringBase64-kodede bildedata, deretter URL-kodet. Maks 10 MB. Korteste side minst 512 px og lengste side høyst 8192 px. Støtter jpg/jpeg/png/bmp. Oppgi enten image eller url.
urlstringFull bilde-URL på opptil 1024 byte. Det kodede bildet må være under 10 MB. Korteste side minst 512 px og lengste side høyst 8192 px. Støtter jpg/jpeg/png/bmp. Oppgi enten image eller url og slå av hotlink-beskyttelse.
return_heatmapstringAngir om et forfalsknings-heatmap skal returneres. Standard: false. true returnerer et Base64-heatmap, false gjør det ikke.
detect_proportionstringAngir om konfidensscoren for manipulering skal returneres. Standard: false. true returnerer scoren, false gjør det ikke.
restrict_probabilitystringTerskel for å returnere koordinater for forfalskning. Område: 0.1 til 1 med 1 desimal. Standard: 0.8. tampered_location returneres bare når probability når eller overskrider terskelen.

Svarparametere

Referanse for API-svarfelter

ParameterTypeBeskrivelse
detection_resultstringManipuleringsresultat: "fake" betyr at manipulering ble oppdaget, "real" betyr at ingen manipulering ble oppdaget.
tampered_proportionfloatKonfidensscore for manipulering, returnert når detect_proportion = true.
heatmapstringBase64-heatmap over manipulerte områder, returnert når return_heatmap = true.
tampered_locationarrayArray med koordinater for mistenkelige områder, returnert når probability er større enn eller lik restrict_probability. Hvert element inneholder left, top, width, height og probability.
leftuint32Horisontal koordinat for øvre venstre hjørne av det mistenkelige området.
topuint32Vertikal koordinat for øvre venstre hjørne av det mistenkelige området.
widthuint32Bredden på det mistenkelige området.
heightuint32Høyden på det mistenkelige området.
probabilityfloatKonfidensscore for dette mistenkelige området.

Feilkoder

Referanse for API-svar koder

Feil KodeFeil Melding
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 vises som rå upstream-verdier slik at de samsvarer nøyaktig med svarene i produksjon.

API Prisplaner

Rimeligere enn engangspakker med kreditter. Abonnementer er fortsatt det billigste alternativet for gjentatt bruk.

Utvikler

$99
500 kreditter
gyldig i 12 måneder

Best for evaluering og tidlig integrasjon

  • Autentisering med Bearer token
  • Forfalskningsresultat, konfidens, heatmap og regionskoordinater
  • Laget for arbeidsflyter som vurderer manipulerte dokumenter og bilder
  • Tilgang til endpoint og token i dashbordet etter kjøp
Mest populær

Vekst

$359
2,000 kreditter
gyldig i 12 måneder

Best for produksjonspiloter og stabil bruk

  • Autentisering med Bearer token
  • Forfalskningsresultat, konfidens, heatmap og regionskoordinater
  • Laget for arbeidsflyter som vurderer manipulerte dokumenter og bilder
  • Tilgang til endpoint og token i dashbordet etter kjøp

Skala

$899
5,000 kreditter
gyldig i 12 måneder

Best for batch-arbeidsflyter og team med flere prosjekter

  • Autentisering med Bearer token
  • Forfalskningsresultat, konfidens, heatmap og regionskoordinater
  • Laget for arbeidsflyter som vurderer manipulerte dokumenter og bilder
  • Tilgang til endpoint og token i dashbordet etter kjøp
Beste verdi

Bedrift

$2,499
15,000 kreditter
gyldig i 12 måneder

Best for langsiktige produksjonsarbeidsbelastninger

  • Autentisering med Bearer token
  • Forfalskningsresultat, konfidens, heatmap og regionskoordinater
  • Laget for arbeidsflyter som vurderer manipulerte dokumenter og bilder
  • Tilgang til endpoint og token i dashbordet etter kjøp

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.

1 API-kreditt = 1 API-forespørsel. API-prisingen er lavere enn engangspakker med kreditter, mens abonnementer fortsatt er det mest økonomiske valget for kontinuerlig bruk.