API pentru Detectarea Falsificării Imaginilor
Acces pentru dezvoltatori

Detectează manipularea documentelor și imaginilor cu un API REST pregătit pentru producție.

Exemple de Cerere și Răspuns

Folosiți aceste exemple pentru a construi și depana integrarea dvs.

Exemplu Cerere HTTP

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

Exemple de Răspuns

Răspuns de succes

Când cererea este validă și imaginea este procesată cu succes, API-ul returnează detection_result pentru a arăta dacă imaginea este falsificată (fake) sau autentică (real), împreună cu scorul de încredere, heatmap și coordonatele atunci când sunt solicitate.

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

Răspuns eroare de afaceri

Când serviciul upstream raportează o eroare de afaceri, API-ul returnează eroare = "API_ERROR" și un cod diferit de zero. Puteți mapa acest cod folosind tabelul codurilor de eroare de mai jos.

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

Introducere API

Tehnologia de Inteligență Artificială specializată în detectarea falsurilor a fost făcută mai ușoară ca niciodată folosind API-ul ImgAuth.com. Cu doar câteva linii de cod, puteți aduce această tehnologie în aplicația dvs.

1

Alege credite API

Selectează pachetul de credite API potrivit volumului tău de integrare

2

Obține acces API

După cumpărare, vezi cheia API și endpoint-ul în panoul contului tău

3

Folosește Exemple de Cod

Folosiți următoarele exemple de cod pentru a începe rapid

4

Intră în producție

Monitorizează utilizarea, ajustează parametrii și treci în producție

Autentificare

Autentifică solicitările cu endpoint-ul API al contului tău și un token Bearer. După cumpărarea creditelor API, poți vedea endpoint-ul și token-ul în panoul contului. Păstrează token-ul secret și nu îl publica niciodată în depozite publice.

Endpoint API

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

Înlocuiește {your-api-domain} cu endpoint-ul API afișat în panoul contului tău.

Anteturi

Autorizare:
Bearer {YOUR_API_TOKEN}
Înlocuiește {YOUR_API_TOKEN} cu token-ul Bearer afișat în panoul contului tău. Păstrează-l secret și nu îl publica niciodată în depozite publice.
Content-Type:
application/json; charset=UTF-8

Exemple de Cod

Începeți rapid cu exemplele noastre de cod

#!/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 de Cerere

Configurați cererile dvs. API cu acești parametri

ParametruTipDescriere
imagestringDate de imagine codificate Base64 și apoi URL-encode. Maximum 10 MB. Latura cea mai scurtă de cel puțin 512 px, iar latura cea mai lungă de cel mult 8192 px. Suportă jpg/jpeg/png/bmp. Furnizează image sau url.
urlstringURL complet al imaginii, de maximum 1024 bytes. Imaginea codificată trebuie să rămână sub 10 MB. Latura cea mai scurtă de cel puțin 512 px, iar latura cea mai lungă de cel mult 8192 px. Suportă jpg/jpeg/png/bmp. Furnizează image sau url și dezactivează protecția hotlink.
return_heatmapstringIndică dacă trebuie returnat un heatmap de falsificare. Implicit: false. true returnează un heatmap Base64, false îl omite.
detect_proportionstringIndică dacă trebuie returnat scorul de încredere al manipulării. Implicit: false. true returnează scorul, false îl omite.
restrict_probabilitystringPragul pentru returnarea coordonatelor de falsificare. Interval: 0.1 până la 1 cu 1 zecimală. Implicit: 0.8. tampered_location este returnat doar când probability atinge sau depășește acest prag.

Parametri de răspuns

Referință pentru câmpurile răspunsului API

ParametruTipDescriere
detection_resultstringRezultatul manipulării: "fake" înseamnă că s-a detectat falsificare, iar "real" înseamnă că nu s-a detectat falsificare.
tampered_proportionfloatScorul de încredere al manipulării, returnat când detect_proportion = true.
heatmapstringHeatmap Base64 al regiunilor falsificate, returnat când return_heatmap = true.
tampered_locationarrayArray cu coordonatele regiunilor suspecte, returnat când probability este mai mare sau egală cu restrict_probability. Fiecare element include left, top, width, height și probability.
leftuint32Coordonata orizontală a colțului stânga-sus al regiunii suspecte.
topuint32Coordonata verticală a colțului stânga-sus al regiunii suspecte.
widthuint32Lățimea regiunii suspecte.
heightuint32Înălțimea regiunii suspecte.
probabilityfloatScorul de încredere pentru această regiune suspectă.

Coduri de Eroare

Referință pentru codurile de răspuns API

Cod de EroareMesaj de Eroare
0success
1000body error
1001param error
1002content type error
1003image not exists
1004image size error
1005image format error
1006invalid signature
1007body size error
1008no authorization
2000server unknown error
2001server timeout
2003no content recognition
2004validate data error
3000remote server error
4000base server error

API messages sunt afișate ca valori brute din serviciul upstream pentru a se potrivi exact cu răspunsurile din producție.

Planuri de Preț API

Mai ieftin decât pachetele de credite cumpărate o singură dată. Abonamentele rămân opțiunea cu cel mai mic cost pentru utilizare recurentă.

Dezvoltator

$99
500 credite
valabil 12 luni

Ideal pentru evaluare și integrare timpurie

  • Autentificare cu Bearer token
  • Rezultat de falsificare, încredere, heatmap și coordonate de regiune
  • Conceput pentru fluxuri de revizuire a documentelor și imaginilor manipulate
  • Acces la endpoint și token din dashboard după achiziție
Cel mai popular

Creștere

$359
2,000 credite
valabil 12 luni

Ideal pentru piloți în producție și utilizare stabilă

  • Autentificare cu Bearer token
  • Rezultat de falsificare, încredere, heatmap și coordonate de regiune
  • Conceput pentru fluxuri de revizuire a documentelor și imaginilor manipulate
  • Acces la endpoint și token din dashboard după achiziție

Scală

$899
5,000 credite
valabil 12 luni

Ideal pentru fluxuri batch și echipe cu mai multe proiecte

  • Autentificare cu Bearer token
  • Rezultat de falsificare, încredere, heatmap și coordonate de regiune
  • Conceput pentru fluxuri de revizuire a documentelor și imaginilor manipulate
  • Acces la endpoint și token din dashboard după achiziție
Cea mai bună valoare

Business

$2,499
15,000 credite
valabil 12 luni

Ideal pentru sarcini de producție pe termen lung

  • Autentificare cu Bearer token
  • Rezultat de falsificare, încredere, heatmap și coordonate de regiune
  • Conceput pentru fluxuri de revizuire a documentelor și imaginilor manipulate
  • Acces la endpoint și token din dashboard după achiziție

De ce dezvoltatorii au încredere în API-ul nostru

Construit pentru sarcini de lucru de producție, API-ul nostru de detectare a falsurilor echilibrează calitatea, performanța și costul astfel încât să vă puteți baza pe el în aplicații reale.

Fiabilitate gata pentru producție

Disponibilitate ridicată și performanță stabilă optimizată pentru trafic real.

Optimizat pentru detectarea falsurilor

Modele concentrate pe documente, certificate și facturi cu detectare a manipulării pentru rezultate mai consistente.

Prețuri previzibile, doar API

Planuri API dedicate cu costuri clare pe credit pentru integrări pe termen lung.

Suport când aveți nevoie

Suport prin email pentru a vă ajuta să diagnosticați probleme și să vă îmbunătățiți integrarea în timp.

1 credit API = 1 cerere API. Prețul API este mai mic decât al pachetelor de credite cumpărate o singură dată, în timp ce abonamentele rămân cea mai economică opțiune pentru utilizare continuă.