Rilevamento Falsificazione Immagini
API

Rileva falsificazioni in qualsiasi immagine con 1 chiamata API

Esempi di Richiesta e Risposta

Usa questi esempi per costruire e debuggare la tua integrazione

Esempio Richiesta HTTP

POST https://{your-api-domain}/forgery_detection
Intestazioni:
  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"
}

Esempi di Risposta

Risposta di successo

When the request is valid and the image is processed successfully, the API returns detection_result indicating whether the image is tampered (fake) or authentic (real), along with optional tampering confidence, heatmap, and location coordinates.

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"
}

Risposta errore commerciale

Quando il servizio upstream segnala un errore commerciale, l'API restituisce errore = "API_ERROR" e un codice diverso da zero. Puoi mappare questo codice utilizzando la tabella dei codici di errore qui sotto.

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."
}

Introduzione API

La tecnologia di Intelligenza Artificiale specializzata nel rilevamento falsificazioni è stata resa più facile che mai utilizzando l'API ImgAuth.com. Con solo poche righe di codice, puoi portare questa tecnologia nella tua applicazione.

1

Acquista Pacchetto

Acquista un pacchetto dedicato all'API

2

Ricevi Email API

Entro 2 ore dal tuo acquisto, riceverai un'email con il tuo dominio API dedicato e AppCode.

3

Usa Esempi di Codice

Usa i seguenti esempi di codice per iniziare rapidamente

4

Regola Parametri

Torna al riferimento dei parametri per regolare la richiesta

Autenticazione

Autentichiamo le richieste utilizzando un dominio API dedicato e un token Bearer per account. Dopo aver acquistato un pacchetto API, ti invieremo un'email con il tuo dominio API unico e token. Per motivi di sicurezza, per favore non pubblicare il tuo token API.

Endpoint API

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

Sostituisci {your-api-domain} con il dominio API che ti inviamo via email dopo l'acquisto. Ogni sviluppatore ha un dominio e token dedicati.

Intestazioni

Autorizzazione:
Bearer {YOUR_API_TOKEN}
Sostituisci {YOUR_API_TOKEN} con il token Bearer che ti inviamo via email. Mantienilo segreto e non committarlo mai in repository pubblici.
Content-Type:
application/json; charset=UTF-8

Esempi di Codice

Inizia rapidamente con i nostri esempi di codice

#!/usr/bin/env bash

set -euo pipefail

# Domain and token for the image processing proxy
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"

# Image file passed as first argument (default: testpaper.jpg)
IMAGE_FILE="${1:-testpaper.jpg}"

if [ ! -f "$IMAGE_FILE" ]; then
  echo "Image file not found: $IMAGE_FILE" >&2
  echo "Usage: $0 path/to/image.jpg" >&2
  exit 1
fi

echo "Encoding image to Base64: $IMAGE_FILE"
# Encode image to Base64 and remove newlines (use -i for BSD base64 on macOS)
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')

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

echo "Calling proxy API..."
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"

echo "Response saved to response.json"

Parametri di Richiesta

Configura le tue richieste API con questi parametri

ParametroTipoDescrizione
imagestringBase64 encoded image data, urlencoded. Size must not exceed 10MB. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required.
urlstringComplete image URL, length not exceeding 1024 bytes. Image size must not exceed 10MB after base64 encoding. Shortest side at least 512px, longest side max 8192px. Supports jpg/jpeg/png/bmp formats. Either image or url is required. Please disable URL hotlink protection.
return_heatmapstringWhether to return forgery region heatmap. Default: false. true: returns base64-encoded heatmap, false: does not return
detect_proportionstringWhether to return image tampering confidence. Default: false. true: returns tampering confidence, false: does not return
restrict_probabilitystringThreshold for returning forgery region coordinates. Range: 0.1 to 1, supports 1 decimal place. Default: 0.8. When forgery region coordinate confidence score (probability) ≥ threshold, tampered_location returns coordinates meeting the threshold, otherwise does not return coordinates

Response Parameters

Reference for API response fields

ParameterTypeDescription
detection_resultstringTampering detection result: "fake" indicates tampering detected, "real" indicates no tampering
tampered_proportionfloatImage tampering confidence (returned when detect_proportion = true in request)
heatmapstringBase64-encoded heatmap of tampered regions (returned when return_heatmap = true in request)
tampered_locationarrayArray of forgery region coordinate information (returned when probability ≥ restrict_probability threshold). Each item contains: left, top, width, height (coordinates), and probability (confidence score)
leftuint32Horizontal coordinate of the top-left vertex of the forgery region
topuint32Vertical coordinate of the top-left vertex of the forgery region
widthuint32Width of the forgery region
heightuint32Height of the forgery region
probabilityfloatConfidence score indicating the probability of forgery in this region

Codici di Errore

Riferimento per i codici di risposta API

Codice di ErroreMessaggio di ErroreDescrizione
0successSuccess
1000body errorRequest body error
1001param errorRequest parameter error
1002content type errorContent-Type error
1003image not existsImage file not found
1004image size errorImage size error
1005image format errorImage format error
1006invalid signatureInvalid signature
1007body size errorBody size error
1008no authorizationAuthorization failed
2000server unknown errorServer unknown error
2001server timeoutServer timeout
2003no content recognitionNo content recognized
2004validate data errorValidation data error
3000remote server errorRemote server error
4000base server errorBase server error

Piani di Prezzo API

I seguenti piani sono esclusivi per API

Starter

$99$0.198 / Credito
500 crediti
Validità 3 mesi
  • Supporta la maggior parte dei formati immagine
  • Correzione e miglioramento documenti
  • Rilevamento falsificazioni documenti
  • Rimozione pattern moiré immagine
  • Velocità elaborazione ~2 secondi
Più Popolare

Popular

$349$0.07 / Credito
5,000 crediti
Validità 6 mesi
  • Supporta la maggior parte dei formati immagine
  • Correzione e miglioramento documenti
  • Rilevamento falsificazioni documenti
  • Rimozione pattern moiré immagine
  • Velocità elaborazione ~2 secondi

Business

$749$0.05 / Credito
15,000 crediti
Validità 1 anno
  • Supporta la maggior parte dei formati immagine
  • Correzione e miglioramento documenti
  • Rilevamento falsificazioni documenti
  • Rimozione pattern moiré immagine
  • Velocità elaborazione ~2 secondi
Esclusivo

Enterprise

$1999$0.04 / Credito
50,000 crediti
Validità 1 anno
  • Supporta la maggior parte dei formati immagine
  • Correzione e miglioramento documenti
  • Rilevamento falsificazioni documenti
  • Rimozione pattern moiré immagine
  • Velocità elaborazione ~2 secondi

Perché gli sviluppatori si fidano della nostra API

Costruita per carichi di lavoro di produzione, la nostra API di rilevamento falsificazioni bilancia qualità, prestazioni e costo così puoi affidarti ad essa in applicazioni reali.

Affidabilità pronta per la produzione

Alta disponibilità e prestazioni stabili ottimizzate per il traffico reale.

Ottimizzato per il rilevamento falsificazioni

Modelli focalizzati su documenti, certificati e fatture con rilevamento manipolazioni per risultati più consistenti.

Prezzi prevedibili, solo API

Piani API dedicati con costi chiari per credito per integrazioni a lungo termine.

Supporto quando ne hai bisogno

Supporto email per aiutarti a diagnosticare problemi e migliorare la tua integrazione nel tempo.

API Rilevamento Falsificazioni Immagini – Rileva Manipolazioni con AI