Détection de Falsification d'Image
API

Détectez les falsifications dans n'importe quelle image avec 1 appel API

Exemples de Requête et Réponse

Utilisez ces exemples pour construire et déboguer votre intégration

Exemple de Requête HTTP

POST https://{your-api-domain}/forgery_detection
En-têtes:
  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"
}

Exemples de Réponse

Réponse réussie

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

Réponse d'erreur commerciale

Lorsque le service en amont signale une erreur commerciale, l'API renvoie erreur = "API_ERROR" et un code non nul. Vous pouvez mapper ce code en utilisant le tableau des codes d'erreur ci-dessous.

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

Introduction API

La technologie d'Intelligence Artificielle spécialisée dans la détection de falsification d'image a été rendue plus facile que jamais en utilisant l'API ImgAuth.com. Avec seulement quelques lignes de code, vous pouvez intégrer cette technologie dans votre application.

1

Acheter un Paquet

Achetez un paquet dédié à l'API

2

Recevoir l'Email API

Dans les 2 heures suivant votre achat, vous recevrez un email avec votre domaine API dédié et AppCode.

3

Utiliser les Exemples de Code

Utilisez les exemples de code suivants pour démarrer rapidement

4

Ajuster les Paramètres

Revenez à la référence des paramètres pour ajuster la requête

Authentification

Nous authentifions les requêtes en utilisant un domaine API dédié et un token Bearer par compte. Après avoir acheté un paquet API, nous vous enverrons un email avec votre domaine API unique et token. Pour des raisons de sécurité, veuillez ne pas publier votre token API.

Point de Terminaison API

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

Remplacez {your-api-domain} par le domaine API que nous vous envoyons par email après l'achat. Chaque développeur a un domaine et un token dédiés.

En-têtes

Autorisation:
Bearer {YOUR_API_TOKEN}
Remplacez {YOUR_API_TOKEN} par le token Bearer que nous vous envoyons par email. Gardez-le secret et ne le commitez jamais dans des dépôts publics.
Content-Type:
application/json; charset=UTF-8

Exemples de Code

Démarrez rapidement avec nos exemples de code

#!/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"

Paramètres de Requête

Configurez vos requêtes API avec ces paramètres

ParamètreTypeDescription
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

Codes d'Erreur

Référence pour les codes de réponse API

Code d'ErreurMessage d'ErreurDescription
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

Plans de Tarification API

Les plans suivants sont exclusifs à l'API

Starter

$99$0.198 / Crédit
500 crédits
Validité de 3 mois
  • Prend en charge la plupart des formats d'image
  • Correction et amélioration de documents
  • Détection de falsifications de documents
  • Suppression du motif moiré de l'image
  • Vitesse de traitement ~2 secondes
Le Plus Populaire

Popular

$349$0.07 / Crédit
5,000 crédits
Validité de 6 mois
  • Prend en charge la plupart des formats d'image
  • Correction et amélioration de documents
  • Détection de falsifications de documents
  • Suppression du motif moiré de l'image
  • Vitesse de traitement ~2 secondes

Business

$749$0.05 / Crédit
15,000 crédits
Validité de 1 an
  • Prend en charge la plupart des formats d'image
  • Correction et amélioration de documents
  • Détection de falsifications de documents
  • Suppression du motif moiré de l'image
  • Vitesse de traitement ~2 secondes
Exclusif

Enterprise

$1999$0.04 / Crédit
50,000 crédits
Validité de 1 an
  • Prend en charge la plupart des formats d'image
  • Correction et amélioration de documents
  • Détection de falsifications de documents
  • Suppression du motif moiré de l'image
  • Vitesse de traitement ~2 secondes

Pourquoi les développeurs font confiance à notre API

Conçu pour les charges de travail de production, notre API de détection de falsifications équilibre qualité, performance et coût afin que vous puissiez vous y fier dans des applications réelles.

Fiabilité prête pour la production

Haute disponibilité et performances stables optimisées pour le trafic réel.

Optimisé pour la détection de falsifications

Modèles axés sur les documents, certificats et factures avec détection de manipulation pour des résultats plus cohérents.

Tarification prévisible, API uniquement

Plans API dédiés avec des coûts clairs par crédit pour les intégrations à long terme.

Support quand vous en avez besoin

Support par email pour vous aider à diagnostiquer les problèmes et améliorer votre intégration au fil du temps.

API de Détection de Falsification d'Images – Détectez la Manipulation avec l'IA