API zur Bildfälschungserkennung
Entwicklerzugang
Erkennen Sie Dokument- und Bildmanipulationen mit einer produktionsreifen REST-API.
Anfrage- und Antwortbeispiele
Verwenden Sie diese Beispiele, um Ihre Integration zu erstellen und zu debuggen
Beispiel-HTTP-Anfrage
POST https://{your-api-domain}/forgery_detection
Header:
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"
}Beispielantworten
Erfolgreiche Antwort
Wenn die Anfrage gültig ist und das Bild erfolgreich verarbeitet wird, gibt die API detection_result zurück und zeigt damit an, ob das Bild manipuliert (fake) oder echt (real) ist. Optional werden Konfidenz, Heatmap und Koordinaten mitgeliefert.
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"
}Geschäftlicher Fehlerantwort
Wenn der Upstream-Service einen Geschäftsfehler meldet, gibt die API Fehler = "API_ERROR" und einen Code ungleich Null zurück. Sie können diesen Code mithilfe der Fehlercodetabelle unten zuordnen.
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-Einführung
Die auf Fälschungserkennung spezialisierte Technologie der künstlichen Intelligenz wurde mit der ImgAuth.com API einfacher als je zuvor. Mit nur wenigen Codezeilen können Sie diese Technologie in Ihre Anwendung integrieren.
API-Credits auswählen
Wählen Sie das API-Credit-Paket passend zu Ihrem Integrationsvolumen
API-Zugang erhalten
Nach dem Kauf sehen Sie Ihren API-Schlüssel und Endpoint im Kontodashboard
Code-Beispiele verwenden
Verwenden Sie die folgenden Code-Beispiele, um schnell zu starten
Live gehen
Nutzung überwachen, Parameter anpassen und in Produktion gehen
Authentifizierung
Authentifizieren Sie Anfragen mit dem API-Endpoint Ihres Kontos und einem Bearer-Token. Nach dem Kauf von API-Credits können Sie Endpoint und Token im Kontodashboard einsehen. Halten Sie Ihr Token geheim und committen Sie es niemals in öffentliche Repositories.
API-Endpunkt
Ersetzen Sie {your-api-domain} durch den im Kontodashboard angezeigten API-Endpoint.
Header
Code-Beispiele
Starten Sie schnell mit unseren Code-Beispielen
#!/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"Anfrageparameter
Konfigurieren Sie Ihre API-Anfragen mit diesen Parametern
| Parameter | Typ | Beschreibung |
|---|---|---|
| image | string | Base64-kodierte Bilddaten, URL-kodiert. Maximal 10 MB. Kürzeste Seite mindestens 512 px, längste Seite höchstens 8192 px. Unterstützt jpg/jpeg/png/bmp. Geben Sie entweder image oder url an. |
| url | string | Vollständige Bild-URL mit maximal 1024 Byte. Das kodierte Bild muss unter 10 MB bleiben. Kürzeste Seite mindestens 512 px, längste Seite höchstens 8192 px. Unterstützt jpg/jpeg/png/bmp. Geben Sie entweder image oder url an und deaktivieren Sie den Hotlink-Schutz. |
| return_heatmap | string | Legt fest, ob eine Manipulations-Heatmap zurückgegeben wird. Standard: false. true liefert eine Base64-Heatmap, false unterdrückt sie. |
| detect_proportion | string | Legt fest, ob der Manipulations-Konfidenzwert zurückgegeben wird. Standard: false. true liefert den Wert, false unterdrückt ihn. |
| restrict_probability | string | Schwellwert für die Rückgabe von Manipulationskoordinaten. Bereich: 0.1 bis 1 mit 1 Dezimalstelle. Standard: 0.8. tampered_location wird nur zurückgegeben, wenn probability den Schwellwert erreicht oder überschreitet. |
Antwortparameter
Referenz der API-Antwortfelder
| Parameter | Typ | Beschreibung |
|---|---|---|
| detection_result | string | Manipulationsergebnis: "fake" bedeutet Manipulation erkannt, "real" bedeutet keine Manipulation erkannt. |
| tampered_proportion | float | Manipulations-Konfidenzwert, wird zurückgegeben wenn detect_proportion = true. |
| heatmap | string | Base64-Heatmap manipulierter Bereiche, wird zurückgegeben wenn return_heatmap = true. |
| tampered_location | array | Array mit Koordinaten verdächtiger Bereiche, wird zurückgegeben wenn probability größer oder gleich restrict_probability ist. Jeder Eintrag enthält left, top, width, height und probability. |
| left | uint32 | Horizontale Koordinate der linken oberen Ecke des verdächtigen Bereichs. |
| top | uint32 | Vertikale Koordinate der linken oberen Ecke des verdächtigen Bereichs. |
| width | uint32 | Breite des verdächtigen Bereichs. |
| height | uint32 | Höhe des verdächtigen Bereichs. |
| probability | float | Konfidenzwert für diesen verdächtigen Bereich. |
Fehlercodes
Referenz für API-Antwortcodes
| Fehlercode | Fehlermeldung |
|---|---|
| 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 werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.
API-Preispläne
Günstiger als einmalige Credit-Pakete. Abonnements bleiben die kostengünstigste Option für wiederkehrende Nutzung.
Entwickler
Ideal für Bewertung und frühe Integration
- Bearer-Token-Authentifizierung
- Manipulationsergebnis, Konfidenz, Heatmap und Bereichskoordinaten
- Für Prüfabläufe bei manipulierten Dokumenten und Bildern ausgelegt
- API-Endpoint und Token nach dem Kauf im Dashboard verfügbar
Wachstum
Ideal für Produktionspiloten und stabile Nutzung
- Bearer-Token-Authentifizierung
- Manipulationsergebnis, Konfidenz, Heatmap und Bereichskoordinaten
- Für Prüfabläufe bei manipulierten Dokumenten und Bildern ausgelegt
- API-Endpoint und Token nach dem Kauf im Dashboard verfügbar
Skalierung
Ideal für Batch-Workflows und Multi-Projekt-Teams
- Bearer-Token-Authentifizierung
- Manipulationsergebnis, Konfidenz, Heatmap und Bereichskoordinaten
- Für Prüfabläufe bei manipulierten Dokumenten und Bildern ausgelegt
- API-Endpoint und Token nach dem Kauf im Dashboard verfügbar
Business
Ideal für langfristige Produktionslasten
- Bearer-Token-Authentifizierung
- Manipulationsergebnis, Konfidenz, Heatmap und Bereichskoordinaten
- Für Prüfabläufe bei manipulierten Dokumenten und Bildern ausgelegt
- API-Endpoint und Token nach dem Kauf im Dashboard verfügbar
Warum Entwickler unserem API vertrauen
Gebaut für Produktionsworkloads, balanciert unser Fälschungserkennungs-API Qualität, Leistung und Kosten aus, sodass Sie sich in realen Apps darauf verlassen können.
Produktionsreife Zuverlässigkeit
Hohe Verfügbarkeit und stabile Leistung, optimiert für realen Datenverkehr.
Optimiert für Fälschungserkennung
Modelle, die sich auf Dokumente, Zertifikate und Rechnungen mit Manipulationserkennung konzentrieren, für konsistentere Ergebnisse.
Vorhersehbare, nur API-Preisgestaltung
Dedizierte API-Pläne mit klaren Kosten pro Credit für langfristige Integrationen.
Support, wenn Sie ihn brauchen
E-Mail-Support, um Ihnen bei der Diagnose von Problemen zu helfen und Ihre Integration im Laufe der Zeit zu verbessern.
1 API-Guthaben = 1 API-Anfrage. Die API-Preise liegen unter den einmaligen Guthaben-Paketen, während Abonnements für fortlaufende Nutzung am günstigsten bleiben.