API voor Beelvervalsingsdetectie
Toegang voor ontwikkelaars
Detecteer manipulatie van documenten en afbeeldingen met een productieklare REST API.
Verzoek- en Antwoord Voorbeelden
Gebruik deze voorbeelden om uw integratie te bouwen en te debuggen
Voorbeeld HTTP Verzoek
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"
}Voorbeeld Antwoorden
Succesvol antwoord
Wanneer het verzoek geldig is en de afbeelding succesvol wordt verwerkt, retourneert de API detection_result om aan te geven of de afbeelding gemanipuleerd is (fake) of authentiek is (real), samen met betrouwbaarheid, heatmap en coördinaten wanneer daarom wordt gevraagd.
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"
}Zakelijke fout antwoord
Wanneer de upstream service een zakelijke fout meldt, retourneert de API fout = "API_ERROR" en een niet-nul code. U kunt deze code mappen met behulp van de foutcode tabel hieronder.
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 Introductie
De kunstmatige intelligentie technologie gespecialiseerd in vervalsingsdetectie is gemakkelijker gemaakt dan ooit met behulp van de ImgAuth.com API. Met slechts een paar regels code kunt u deze technologie in uw applicatie brengen.
Kies API-credits
Selecteer het API-creditpakket dat past bij je integratievolume
Krijg API-toegang
Bekijk na aankoop je API-sleutel en endpoint in je accountdashboard
Code Voorbeelden Gebruiken
Gebruik de volgende codevoorbeelden om snel te beginnen
Ga live
Controleer het gebruik, pas parameters aan en ga naar productie
Authenticatie
Authenticeer verzoeken met het API-endpoint van je account en een Bearer-token. Na aankoop van API-credits kun je je endpoint en token bekijken in je accountdashboard. Houd je token geheim en commit het nooit naar openbare repositories.
API Eindpunt
Vervang {your-api-domain} door het API-endpoint dat in je accountdashboard wordt weergegeven.
Headers
Code Voorbeelden
Begin snel met onze codevoorbeelden
#!/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"Verzoek Parameters
Configureer uw API-verzoeken met deze parameters
| Parameter | Type | Beschrijving |
|---|---|---|
| image | string | In Base64 gecodeerde afbeeldingsgegevens, daarna URL-encoded. Maximaal 10 MB. Kortste zijde minimaal 512 px en langste zijde maximaal 8192 px. Ondersteunt jpg/jpeg/png/bmp. Geef image of url op. |
| url | string | Volledige afbeeldings-URL van maximaal 1024 bytes. De gecodeerde afbeelding moet onder 10 MB blijven. Kortste zijde minimaal 512 px en langste zijde maximaal 8192 px. Ondersteunt jpg/jpeg/png/bmp. Geef image of url op en schakel hotlink-bescherming uit. |
| return_heatmap | string | Geeft aan of een vervalsings-heatmap moet worden geretourneerd. Standaard: false. true retourneert een Base64-heatmap, false niet. |
| detect_proportion | string | Geeft aan of de betrouwbaarheidsscore van manipulatie moet worden geretourneerd. Standaard: false. true retourneert de score, false niet. |
| restrict_probability | string | Drempel voor het retourneren van vervalsingscoördinaten. Bereik: 0.1 tot 1 met 1 decimaal. Standaard: 0.8. tampered_location wordt alleen geretourneerd wanneer probability de drempel bereikt of overschrijdt. |
Responsparameters
Referentie voor API-responsvelden
| Parameter | Type | Beschrijving |
|---|---|---|
| detection_result | string | Manipulatieresultaat: "fake" betekent dat manipulatie is gedetecteerd en "real" betekent dat er geen manipulatie is gedetecteerd. |
| tampered_proportion | float | Betrouwbaarheidsscore van manipulatie, geretourneerd wanneer detect_proportion = true. |
| heatmap | string | Base64-heatmap van gemanipuleerde gebieden, geretourneerd wanneer return_heatmap = true. |
| tampered_location | array | Array met coördinaten van verdachte gebieden, geretourneerd wanneer probability groter dan of gelijk aan restrict_probability is. Elk item bevat left, top, width, height en probability. |
| left | uint32 | Horizontale coördinaat van de linkerbovenhoek van het verdachte gebied. |
| top | uint32 | Verticale coördinaat van de linkerbovenhoek van het verdachte gebied. |
| width | uint32 | Breedte van het verdachte gebied. |
| height | uint32 | Hoogte van het verdachte gebied. |
| probability | float | Betrouwbaarheidsscore voor dit verdachte gebied. |
Foutcodes
Referentie voor API-antwoordcodes
| Foutcode | Foutmelding |
|---|---|
| 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 worden als ruwe upstream-waarden getoond zodat ze exact overeenkomen met productieantwoorden.
API Prijsplannen
Goedkoper dan eenmalige creditpacks. Abonnementen blijven de voordeligste optie voor terugkerend gebruik.
Ontwikkelaar
Beste voor evaluatie en vroege integratie
- Authenticatie met Bearer token
- Vervalsingsresultaat, betrouwbaarheid, heatmap en regiocoördinaten
- Gemaakt voor workflows voor controle van gemanipuleerde documenten en afbeeldingen
- Toegang tot endpoint en token via het dashboard na aankoop
Groei
Beste voor productiepilots en stabiel gebruik
- Authenticatie met Bearer token
- Vervalsingsresultaat, betrouwbaarheid, heatmap en regiocoördinaten
- Gemaakt voor workflows voor controle van gemanipuleerde documenten en afbeeldingen
- Toegang tot endpoint en token via het dashboard na aankoop
Schaal
Beste voor batchworkflows en teams met meerdere projecten
- Authenticatie met Bearer token
- Vervalsingsresultaat, betrouwbaarheid, heatmap en regiocoördinaten
- Gemaakt voor workflows voor controle van gemanipuleerde documenten en afbeeldingen
- Toegang tot endpoint en token via het dashboard na aankoop
Zakelijk
Beste voor langdurige productieworkloads
- Authenticatie met Bearer token
- Vervalsingsresultaat, betrouwbaarheid, heatmap en regiocoördinaten
- Gemaakt voor workflows voor controle van gemanipuleerde documenten en afbeeldingen
- Toegang tot endpoint en token via het dashboard na aankoop
Waarom ontwikkelaars vertrouwen op onze API
Gebouwd voor productieworkloads, balanceert onze vervalsingsdetectie-API kwaliteit, prestaties en kosten zodat u erop kunt vertrouwen in echte apps.
Productieklare betrouwbaarheid
Hoge beschikbaarheid en stabiele prestaties afgestemd op echt verkeer.
Geoptimaliseerd voor vervalsingsdetectie
Modellen gericht op documenten, certificaten en facturen met manipulatie detectie voor meer consistente resultaten.
Voorspelbare, alleen API-prijzen
Toegewijde API-plannen met duidelijke kosten per credit voor langetermijnintegraties.
Ondersteuning wanneer u het nodig heeft
E-mailondersteuning om u te helpen problemen te diagnosticeren en uw integratie in de loop van de tijd te verbeteren.
1 API-credit = 1 API-verzoek. API-prijzen zijn lager dan eenmalige creditpacks, terwijl abonnementen de meest voordelige optie blijven voor doorlopend gebruik.