AiVidect AiVidect Enterprise

English English Español Spanish Português Portuguese Français French Deutsch German العربية Arabic हिन्दी Hindi 日本語 Japanese 한국어 Korean 中文 Chinese Русский Russian
Iniciar Sesion Prueba el Detector de Deepfake Gratis

Documentacion de API de Deteccion de Deepfake

Integre la deteccion de deepfake en su aplicacion con nuestra potente API REST. Detecte videos generados por IA, medios sinteticos y contenido manipulado programaticamente.

Inicio Rapido

curl -X POST https://aividect.com/api/v1/analyze \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://instagram.com/reel/example"}'
Obtenga su clave API

Autenticacion

Todas las solicitudes de API requieren autenticacion usando una clave API. Incluya su clave en el encabezado de Autorizacion:

Encabezado de Autorizacion

Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxx

Generate and manage your API keys from your Account Settings.

Limites de Tasa

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

Endpoints

GET /api/v1/me

Obtenga informacion sobre la clave API actual y la cuenta de usuario.

Respuesta

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

Analizar un video desde URL. Soporta YouTube, TikTok, Instagram, Twitter y enlaces de video directos. Cada analisis cuesta 1 credito.

Request Body

Parameter Tipo Descripcion
urlrequerido string URL del video a analizar

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);

Respuesta

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

Recuperar un resultado de analisis especifico por su ID.

Path Parameters

Parameter Tipo Descripcion
idrequerido string El ID de analisis devuelto de /analyze

Respuesta

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

Lista tus análisis recientes con paginación.

Query Parameters

Parameter Tipo Descripcion
pageopcional integer Número de página (predeterminado: 1)
per_pageopcional integer Resultados por página (predeterminado: 20, máx: 100)
GET /api/v1/usage

Obtén estadísticas de uso de API y límites restantes.

Respuesta

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

Codigos de Error

HTTP Code Error Code Descripcion
400 INVALID_REQUEST El cuerpo de la solicitud no es JSON válido
400 MISSING_URL El parámetro URL es requerido
400 DOWNLOAD_FAILED No se pudo descargar el video desde la URL
401 MISSING_AUTH El encabezado de autorización es requerido
401 INVALID_KEY La clave API no es válida
401 KEY_REVOKED La clave API ha sido revocada
402 INSUFFICIENT_CREDITS No quedan créditos
429 RATE_LIMIT_EXCEEDED Límite diario de API excedido
500 INTERNAL_ERROR Error del servidor, inténtalo más tarde

Formato de Respuesta de Error

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

¿Listo para Comenzar?

Genera tu clave API y comienza a detectar videos de IA en minutos.

Obtén Tu Clave API