API til Registrering af Billedforfalskning
Udvikleradgang
Registrer manipulation af dokumenter og billeder med et produktionsklart REST API.
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
Når anmodningen er gyldig, og billedet behandles korrekt, returnerer API’en detection_result for at vise, om billedet er manipuleret (fake) eller ægte (real), sammen med sikkerhedsscore, heatmap og koordinater, når de er anmodet om.
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.
Vælg API-kreditter
Vælg den API-kreditpakke, der passer til dit integrationsvolumen
Få API-adgang
Efter køb kan du se din API-nøgle og endpoint i din kontodashboard
Brug kodeeksempler
Brug følgende kodeeksempler for at komme i gang hurtigt
Gå i produktion
Overvåg brugen, justér parametre og gå i produktion
Godkendelse
Godkend anmodninger med din kontos API-endpoint og et Bearer-token. Efter køb af API-kreditter kan du se endpoint og token i din kontodashboard. Hold dit token hemmeligt, og commit det aldrig til offentlige repositories.
API-endpoint
Erstat {your-api-domain} med API-endpointet vist i din kontodashboard.
Headers
Kodeeksempler
Kom i gang hurtigt med vores 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"Anmodningsparametre
Konfigurer dine API-anmodninger med disse parametre
| Parameter | Type | Beskrivelse |
|---|---|---|
| image | string | Base64-kodede billeddata, derefter URL-kodet. Maksimalt 10 MB. Korteste side mindst 512 px og længste side højst 8192 px. Understøtter jpg/jpeg/png/bmp. Angiv enten image eller url. |
| url | string | Komplet billed-URL på højst 1024 byte. Det kodede billede skal være under 10 MB. Korteste side mindst 512 px og længste side højst 8192 px. Understøtter jpg/jpeg/png/bmp. Angiv enten image eller url, og deaktiver hotlink-beskyttelse. |
| return_heatmap | string | Angiver om et forfalsknings-heatmap skal returneres. Standard: false. true returnerer et Base64-heatmap, false gør ikke. |
| detect_proportion | string | Angiver om sikkerhedsscoren for manipulation skal returneres. Standard: false. true returnerer scoren, false gør ikke. |
| restrict_probability | string | Tærskel for at returnere forfalskningskoordinater. Interval: 0.1 til 1 med 1 decimal. Standard: 0.8. tampered_location returneres kun, når probability når eller overstiger tærsklen. |
Svarparametre
Reference til API-svarfelter
| Parameter | Type | Beskrivelse |
|---|---|---|
| detection_result | string | Manipulationsresultat: "fake" betyder, at manipulation blev fundet, og "real" betyder, at der ikke blev fundet manipulation. |
| tampered_proportion | float | Sikkerhedsscoren for manipulation, returneret når detect_proportion = true. |
| heatmap | string | Base64-heatmap over manipulerede områder, returneret når return_heatmap = true. |
| tampered_location | array | Array med koordinater for mistænkelige områder, returneret når probability er større end eller lig med restrict_probability. Hvert element indeholder left, top, width, height og probability. |
| left | uint32 | Vandret koordinat for øverste venstre hjørne af det mistænkelige område. |
| top | uint32 | Lodret koordinat for øverste venstre hjørne af det mistænkelige område. |
| width | uint32 | Bredden af det mistænkelige område. |
| height | uint32 | Højden af det mistænkelige område. |
| probability | float | Sikkerhedsscoren for dette mistænkelige område. |
Fejlkoder
Reference for API-svar koder
| Fejl kode | Fejl besked |
|---|---|
| 0 | success |
| 1000 | body error |
| 1001 | param error |
| 1002 | content type error |
| 1003 | image not exists |
| 1004 | image size error |
| 1005 | image format error |
| 1006 | invalid signature |
| 1007 | body size error |
| 1008 | no authorization |
| 2000 | server unknown error |
| 2001 | server timeout |
| 2003 | no content recognition |
| 2004 | validate data error |
| 3000 | remote server error |
| 4000 | base server error |
API messages vises som rå upstream-værdier, så de matcher svarene i produktion præcist.
API Prisplaner
Billigere end engangspakker med kreditter. Abonnementer er stadig den billigste løsning til tilbagevendende brug.
Udvikler
Bedst til evaluering og tidlig integration
- Bearer token-godkendelse
- Forfalskningsresultat, sikkerhedsscore, heatmap og områdekoordinater
- Bygget til workflow for gennemgang af manipulerede dokumenter og billeder
- Adgang til endpoint og token i dashboardet efter køb
Vækst
Bedst til produktionspiloter og stabil brug
- Bearer token-godkendelse
- Forfalskningsresultat, sikkerhedsscore, heatmap og områdekoordinater
- Bygget til workflow for gennemgang af manipulerede dokumenter og billeder
- Adgang til endpoint og token i dashboardet efter køb
Skala
Bedst til batch-workflows og teams med flere projekter
- Bearer token-godkendelse
- Forfalskningsresultat, sikkerhedsscore, heatmap og områdekoordinater
- Bygget til workflow for gennemgang af manipulerede dokumenter og billeder
- Adgang til endpoint og token i dashboardet efter køb
Business
Bedst til langsigtede produktionsarbejdsbelastninger
- Bearer token-godkendelse
- Forfalskningsresultat, sikkerhedsscore, heatmap og områdekoordinater
- Bygget til workflow for gennemgang af manipulerede dokumenter og billeder
- Adgang til endpoint og token i dashboardet efter køb
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.
1 API-kredit = 1 API-anmodning. API-priserne er lavere end engangspakker med kreditter, mens abonnementer stadig er den mest økonomiske løsning til løbende brug.