AiVidect AiVidect Enterprise

Deepfake-Erkennungs-API-Dokumentation

Integrieren Sie Deepfake-Erkennung in Ihre Anwendung mit unserer leistungsstarken REST-API. Erkennen Sie KI-generierte Videos, synthetische Medien und manipulierte Inhalte programmatisch.

Schnellstart

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"}'
Holen Sie sich Ihren API-Schlüssel

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Fugen Sie Ihren Schlüssel in den Authorization-Header ein:

Autorisierungsheader

Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxx

Generate and manage your API keys from your Account Settings.

Ratenlimits

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

Endpunkte

GET /api/v1/me

Informationen zum aktuellen API-Schlüssel und Benutzerkonto abrufen.

Antwort

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

Ein Video von einer URL analysieren. Unterstützt YouTube, TikTok, Instagram, Twitter und direkte Videolinks. Jede Analyse kostet 1 Credit.

Request Body

Parameter Typ Beschreibung
urlerforderlich string URL des zu analysierenden Videos

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

Antwort

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

Ein spezifisches Analyseergebnis anhand seiner ID abrufen.

Path Parameters

Parameter Typ Beschreibung
iderforderlich string Die von /analyze zurückgegebene Analyse-ID

Antwort

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

Listen Sie Ihre letzten Analysen mit Paginierung auf.

Query Parameters

Parameter Typ Beschreibung
pageoptional integer Seitennummer (Standard: 1)
per_pageoptional integer Ergebnisse pro Seite (Standard: 20, Max: 100)
GET /api/v1/usage

API-Nutzungsstatistiken und verbleibende Limits abrufen.

Antwort

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

Fehlercodes

HTTP Code Error Code Beschreibung
400 INVALID_REQUEST Anfragekörper ist kein gültiges JSON
400 MISSING_URL URL-Parameter ist erforderlich
400 DOWNLOAD_FAILED Video konnte nicht von URL heruntergeladen werden
401 MISSING_AUTH Autorisierungsheader ist erforderlich
401 INVALID_KEY API-Schlüssel ist ungültig
401 KEY_REVOKED API-Schlüssel wurde widerrufen
402 INSUFFICIENT_CREDITS Keine Guthaben mehr
429 RATE_LIMIT_EXCEEDED Tägliches API-Limit überschritten
500 INTERNAL_ERROR Serverfehler, versuchen Sie es später erneut

Fehlerantwortformat

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

Bereit Loszulegen?

Generieren Sie Ihren API-Schlüssel und beginnen Sie in Minuten mit der Erkennung von KI-Videos.

Holen Sie Sich Ihren API-Schlüssel