Documentation API de Detection de Deepfake

Integrez la detection de deepfake dans votre application avec notre puissante API REST. Detectez les videos generees par IA, les medias synthetiques et le contenu manipule de maniere programmatique.

Authentification

Toutes les requetes API necessitent une authentification a l'aide d'une cle API. Incluez votre cle dans l'en-tete Authorization:

En-tete d'Autorisation

Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxx

Generate and manage your API keys from your Account Settings.

Limites de Taux

Free: 10 requests/day | Pro: 100 requests/day | Business: 1,000 requests/day | Enterprise: Illimite

Points de Terminaison

GET /api/v1/me

Obtenez des informations sur la cle API actuelle et le compte utilisateur.

Reponse

{
  "success": true,
  "user": {
    "id": 123,
    "username": "john_doe",
    "email": "john@example.com",
    "tier": "pro",
    "credits_balance": 45
  },
  "api_key": {
    "name": "Production",
    "prefix": "ak_x7Kp9mN2",
    "daily_requests": 12,
    "daily_limit": 100
  }
}

POST /api/v1/analyze

Analyser une video a partir d'une URL. Prend en charge YouTube, TikTok, Instagram, Twitter et les liens video directs. Chaque analyse coute 1 credit.

Request Body

Parameter	Type	Description
urlrequis	string	URL de la video a analyser

Example Request

curl -X POST https://aividect.com/api/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://tiktok.com/@user/video/123"}'

import requests

response = requests.post(
    "https://aividect.com/api/v1/analyze",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"url": "https://tiktok.com/@user/video/123"}
)

result = response.json()
if result["success"]:
    print(f"Result: {result['result']}")
    print(f"Confidence: {result['confidence']}%")

const response = await fetch("https://aividect.com/api/v1/analyze", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ url: "https://tiktok.com/@user/video/123" })
});

const result = await response.json();
console.log(result.result, result.confidence);

Reponse

{
  "success": true,
  "analysis_id": "a1b2c3d4e5f6",
  "result": "ai_generated",
  "confidence": 94.5,
  "prob_fake": 0.945,
  "prob_real": 0.055,
  "model": {
    "name": "VideoEfficientAttn",
    "version": "epoch25_auc0.95"
  },
  "processing_time_ms": 4523,
  "credits_remaining": 44,
  "created_at": "2024-01-15T10:30:00Z"
}

GET /api/v1/analysis/{id}

Recuperer un resultat d'analyse specifique par son ID.

Path Parameters

Parameter	Type	Description
idrequis	string	L'ID d'analyse retourne par /analyze

Reponse

{
  "success": true,
  "analysis": {
    "id": "a1b2c3d4e5f6",
    "result": "ai_generated",
    "confidence": 94.5,
    "source_type": "url",
    "source_url": "https://tiktok.com/...",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

GET /api/v1/analyses

Listez vos analyses récentes avec pagination.

Query Parameters

Parameter	Type	Description
pageoptionnel	integer	Numéro de page (par défaut : 1)
per_pageoptionnel	integer	Résultats par page (par défaut : 20, max : 100)

GET /api/v1/usage

Obtenez les statistiques d'utilisation de l'API et les limites restantes.

Reponse

{
  "success": true,
  "usage": {
    "credits_balance": 45,
    "analyses_today": 12,
    "analyses_week": 87,
    "analyses_month": 342
  },
  "limits": {
    "tier": "pro",
    "daily_api_limit": 100,
    "daily_api_used": 12,
    "daily_api_remaining": 88
  }
}

Codes d'Erreur

HTTP Code	Error Code	Description
400	INVALID_REQUEST	Le corps de la requête n'est pas un JSON valide
400	MISSING_URL	Le paramètre URL est requis
400	DOWNLOAD_FAILED	Impossible de télécharger la vidéo depuis l'URL
401	MISSING_AUTH	L'en-tête d'autorisation est requis
401	INVALID_KEY	La clé API est invalide
401	KEY_REVOKED	La clé API a été révoquée
402	INSUFFICIENT_CREDITS	Plus de crédits disponibles
429	RATE_LIMIT_EXCEEDED	Limite quotidienne de l'API dépassée
500	INTERNAL_ERROR	Erreur serveur, réessayez plus tard

Format de Réponse d'Erreur

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "No credits remaining. Please purchase more."
  }
}

Prêt à Commencer ?

Générez votre clé API et commencez à détecter les vidéos IA en quelques minutes.

Obtenez Votre Clé API

AiVidect Enterprise

Documentation API de Detection de Deepfake

Demarrage Rapide

Authentification

En-tete d'Autorisation

Limites de Taux

Points de Terminaison

Reponse

Request Body

Example Request

Reponse

Path Parameters

Reponse

Query Parameters

Reponse

Codes d'Erreur

Format de Réponse d'Erreur

Prêt à Commencer ?