API per il Rilevamento della Falsificazione delle Immagini
Accesso sviluppatori
Rileva manomissioni di documenti e immagini con una REST API pronta per la produzione.
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
Quando la richiesta è valida e l’immagine viene elaborata correttamente, l’API restituisce detection_result per indicare se l’immagine è manomessa (fake) o autentica (real), insieme a confidenza, heatmap e coordinate quando richiesti.
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.
Scegli i crediti API
Seleziona il pacchetto di crediti API adatto al tuo volume di integrazione
Ottieni accesso API
Dopo l’acquisto, visualizza la tua chiave API e l’endpoint nella dashboard del tuo account
Usa Esempi di Codice
Usa i seguenti esempi di codice per iniziare rapidamente
Vai in produzione
Monitora l’uso, regola i parametri e passa alla produzione
Autenticazione
Autentica le richieste con l’endpoint API del tuo account e un token Bearer. Dopo l’acquisto dei crediti API, puoi vedere endpoint e token nella dashboard del tuo account. Mantieni segreto il token e non pubblicarlo mai in repository pubblici.
Endpoint API
Sostituisci {your-api-domain} con l’endpoint API mostrato nella dashboard del tuo account.
Intestazioni
Esempi di Codice
Inizia rapidamente con i nostri esempi di codice
#!/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"Parametri di Richiesta
Configura le tue richieste API con questi parametri
| Parametro | Tipo | Descrizione |
|---|---|---|
| image | string | Dati immagine codificati in Base64 e poi URL-encoded. Massimo 10 MB. Lato più corto di almeno 512 px e lato più lungo di massimo 8192 px. Supporta jpg/jpeg/png/bmp. Fornisci image oppure url. |
| url | string | URL completo dell’immagine, fino a 1024 byte. L’immagine codificata deve restare sotto i 10 MB. Lato più corto di almeno 512 px e lato più lungo di massimo 8192 px. Supporta jpg/jpeg/png/bmp. Fornisci image oppure url e disabilita la protezione hotlink. |
| return_heatmap | string | Indica se restituire una heatmap di falsificazione. Predefinito: false. true restituisce una heatmap Base64, false la omette. |
| detect_proportion | string | Indica se restituire il punteggio di confidenza della manomissione. Predefinito: false. true restituisce il punteggio, false lo omette. |
| restrict_probability | string | Soglia per restituire le coordinate di falsificazione. Intervallo: da 0.1 a 1 con 1 cifra decimale. Predefinito: 0.8. tampered_location viene restituito solo quando probability raggiunge o supera questa soglia. |
Parametri di risposta
Riferimento dei campi di risposta API
| Parametro | Tipo | Descrizione |
|---|---|---|
| detection_result | string | Risultato della manomissione: "fake" indica manipolazione rilevata, "real" indica nessuna manipolazione rilevata. |
| tampered_proportion | float | Punteggio di confidenza della manomissione, restituito quando detect_proportion = true. |
| heatmap | string | Heatmap Base64 delle regioni manomesse, restituita quando return_heatmap = true. |
| tampered_location | array | Array delle coordinate delle regioni sospette, restituito quando probability è maggiore o uguale a restrict_probability. Ogni elemento include left, top, width, height e probability. |
| left | uint32 | Coordinata orizzontale dell’angolo in alto a sinistra della regione sospetta. |
| top | uint32 | Coordinata verticale dell’angolo in alto a sinistra della regione sospetta. |
| width | uint32 | Larghezza della regione sospetta. |
| height | uint32 | Altezza della regione sospetta. |
| probability | float | Punteggio di confidenza per questa regione sospetta. |
Codici di Errore
Riferimento per i codici di risposta API
| Codice di Errore | Messaggio di Errore |
|---|---|
| 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 |
Gli API messages vengono mostrati come valori grezzi del servizio upstream per corrispondere esattamente alle risposte viste in produzione.
Piani di Prezzo API
Più conveniente dei pacchetti di crediti una tantum. Gli abbonamenti restano l’opzione meno costosa per l’uso ricorrente.
Sviluppatore
Ideale per valutazione e integrazione iniziale
- Autenticazione con Bearer token
- Risultato di falsificazione, confidenza, heatmap e coordinate della regione
- Pensato per flussi di revisione di documenti e immagini manipolati
- Accesso a endpoint e token dal dashboard dopo l’acquisto
Crescita
Ideale per piloti in produzione e uso stabile
- Autenticazione con Bearer token
- Risultato di falsificazione, confidenza, heatmap e coordinate della regione
- Pensato per flussi di revisione di documenti e immagini manipolati
- Accesso a endpoint e token dal dashboard dopo l’acquisto
Scala
Ideale per workflow batch e team multi-progetto
- Autenticazione con Bearer token
- Risultato di falsificazione, confidenza, heatmap e coordinate della regione
- Pensato per flussi di revisione di documenti e immagini manipolati
- Accesso a endpoint e token dal dashboard dopo l’acquisto
Business
Ideale per carichi di produzione a lungo termine
- Autenticazione con Bearer token
- Risultato di falsificazione, confidenza, heatmap e coordinate della regione
- Pensato per flussi di revisione di documenti e immagini manipolati
- Accesso a endpoint e token dal dashboard dopo l’acquisto
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.
1 credito API = 1 richiesta API. Il prezzo API è inferiore a quello dei pacchetti di crediti una tantum, mentre gli abbonamenti restano l’opzione più economica per l’uso continuo.