API de Détection de Falsification d’Images
Accès développeur
Détectez les altérations de documents et d’images avec une API REST prête pour la production.
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
Lorsque la requête est valide et que l’image est traitée avec succès, l’API renvoie detection_result pour indiquer si l’image est falsifiée (fake) ou authentique (real), ainsi que, si demandé, le score de confiance, la heatmap et les coordonnées.
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.
Choisir des crédits API
Sélectionnez le pack de crédits API adapté à votre volume d’intégration
Obtenir l’accès API
Après l’achat, consultez votre clé API et votre endpoint dans le tableau de bord de votre compte
Utiliser les Exemples de Code
Utilisez les exemples de code suivants pour démarrer rapidement
Passer en production
Surveillez l’usage, ajustez les paramètres et passez en production
Authentification
Authentifiez les requêtes avec l’endpoint API de votre compte et un jeton Bearer. Après l’achat de crédits API, vous pouvez voir votre endpoint et votre jeton dans le tableau de bord de votre compte. Gardez votre jeton secret et ne le publiez jamais dans un dépôt public.
Point de Terminaison API
Remplacez {your-api-domain} par l’endpoint API affiché dans le tableau de bord de votre compte.
En-têtes
Exemples de Code
Démarrez rapidement avec nos exemples de code
#!/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"Paramètres de Requête
Configurez vos requêtes API avec ces paramètres
| Paramètre | Type | Description |
|---|---|---|
| image | string | Données d’image encodées en Base64 puis URL-encodées. Maximum 10 MB. Côté le plus court au moins 512 px, côté le plus long au plus 8192 px. Prend en charge jpg/jpeg/png/bmp. Fournissez image ou url. |
| url | string | URL complète de l’image, 1024 octets maximum. L’image encodée doit rester sous 10 MB. Côté le plus court au moins 512 px, côté le plus long au plus 8192 px. Prend en charge jpg/jpeg/png/bmp. Fournissez image ou url et désactivez la protection anti-hotlink. |
| return_heatmap | string | Indique s’il faut renvoyer une heatmap de falsification. Par défaut : false. true renvoie une heatmap Base64, false ne la renvoie pas. |
| detect_proportion | string | Indique s’il faut renvoyer le score de confiance de falsification. Par défaut : false. true renvoie le score, false l’omet. |
| restrict_probability | string | Seuil pour renvoyer les coordonnées des zones falsifiées. Plage : 0.1 à 1 avec 1 décimale. Valeur par défaut : 0.8. tampered_location n’est renvoyé que si probability atteint ou dépasse ce seuil. |
Paramètres de réponse
Référence des champs de réponse API
| Paramètre | Type | Description |
|---|---|---|
| detection_result | string | Résultat de falsification : "fake" signifie qu’une manipulation a été détectée, "real" qu’aucune manipulation n’a été détectée. |
| tampered_proportion | float | Score de confiance de falsification, renvoyé lorsque detect_proportion = true. |
| heatmap | string | Heatmap Base64 des zones falsifiées, renvoyée lorsque return_heatmap = true. |
| tampered_location | array | Tableau des coordonnées des zones suspectes, renvoyé lorsque probability est supérieure ou égale à restrict_probability. Chaque élément contient left, top, width, height et probability. |
| left | uint32 | Coordonnée horizontale du coin supérieur gauche de la zone suspecte. |
| top | uint32 | Coordonnée verticale du coin supérieur gauche de la zone suspecte. |
| width | uint32 | Largeur de la zone suspecte. |
| height | uint32 | Hauteur de la zone suspecte. |
| probability | float | Score de confiance de cette zone suspecte. |
Codes d'Erreur
Référence pour les codes de réponse API
| Code d'Erreur | Message d'Erreur |
|---|---|
| 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 |
Les API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.
Plans de Tarification API
Moins cher que les packs de crédits à usage unique. Les abonnements restent l’option la moins coûteuse pour un usage récurrent.
Développeur
Idéal pour l’évaluation et l’intégration initiale
- Authentification par jeton Bearer
- Résultat de falsification, score de confiance, heatmap et coordonnées des zones
- Conçu pour les workflows de revue de documents et d’images manipulés
- Accès à l’endpoint API et au jeton depuis le tableau de bord après achat
Croissance
Idéal pour les pilotes en production et un usage régulier
- Authentification par jeton Bearer
- Résultat de falsification, score de confiance, heatmap et coordonnées des zones
- Conçu pour les workflows de revue de documents et d’images manipulés
- Accès à l’endpoint API et au jeton depuis le tableau de bord après achat
Échelle
Idéal pour les workflows par lots et les équipes multi-projets
- Authentification par jeton Bearer
- Résultat de falsification, score de confiance, heatmap et coordonnées des zones
- Conçu pour les workflows de revue de documents et d’images manipulés
- Accès à l’endpoint API et au jeton depuis le tableau de bord après achat
Entreprise
Idéal pour les charges de production à long terme
- Authentification par jeton Bearer
- Résultat de falsification, score de confiance, heatmap et coordonnées des zones
- Conçu pour les workflows de revue de documents et d’images manipulés
- Accès à l’endpoint API et au jeton depuis le tableau de bord après achat
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.
1 crédit API = 1 requête API. Le prix de l’API est inférieur à celui des packs de crédits à usage unique, tandis que l’abonnement reste l’option la plus économique pour un usage continu.