Visage réel ou IA API

Introduction API

Vérifiez si un visage paraît réel ou généré par IA, notamment les indices de visages synthétiques, d’échange de visages par IA et de retouche intensive assistée par IA. Le modèle analyse l’ensemble de l’image et renvoie un score de risque de génération par IA.

Paramètres de Requête: Fichiers de portrait pris en charge jusqu’à 10 Mo.
Paramètres de réponse: Un score plus élevé indique des signaux de génération par IA plus forts sur l’image entière. Utilisez-le comme indice de vérification, pas comme preuve que l’image est réelle.

Introduction API

Vérifier si une photo de profil paraît réelle ou générée par IA
Examiner les selfies et portraits pour détecter des visages synthétiques
Repérer un éventuel échange de visages par IA ou une retouche intensive assistée par IA

Authentification

Remplacez {your-api-domain} par l’endpoint API affiché dans le tableau de bord de votre compte.

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.

POSThttps://api.imgauth.com/v1/real-or-ai-face

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

Paramètres de Requête

Paramètre	Type	✓	Description
image	string	✓	Fichiers de portrait pris en charge jusqu’à 10 Mo.

Exemple de Requête HTTP

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

Paramètres de réponse

Paramètre	Type	Description
code	integer	Référence pour les codes de réponse API
request_id	string	Utilisez ces exemples pour construire et déboguer votre intégration
data.ai_generated	boolean \| null	Image de visage probablement générée ou fortement modifiée par IA / Aucun signal fort de génération IA détecté
data.ai_generation_score	number \| null	Un score plus élevé indique des signaux de génération par IA plus forts sur l’image entière. Utilisez-le comme indice de vérification, pas comme preuve que l’image est réelle.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	Vérification recommandée
data.analysis_scope	"portrait"	Vérifiez si un visage paraît réel ou généré par IA, notamment les indices de visages synthétiques, d’échange de visages par IA et de retouche intensive assistée par IA. Le modèle analyse l’ensemble de l’image et renvoie un score de risque de génération par IA.

Exemples de Réponse

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "ai_generated": true,
    "ai_generation_score": 0.89,
    "review_status": "likely_ai",
    "analysis_scope": "portrait"
  }
}

Codes d'Erreur

400INVALID_REQUESTLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

401INVALID_API_KEYLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

402CREDITS_EXHAUSTEDLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

403API_KEY_INACTIVE / API_KEY_EXPIREDLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

413PAYLOAD_TOO_LARGELes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

415UNSUPPORTED_IMAGELes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

502UPSTREAM_ERRORLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

504UPSTREAM_TIMEOUTLes API messages sont affichés avec leurs valeurs brutes amont afin de correspondre exactement aux réponses vues en production.

Exemples de Code

curl -X POST "https://api.imgauth.com/v1/real-or-ai-face" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}'