توثيق API كشف التزييف العميق

قم بدمج كشف التزييف العميق في تطبيقك باستخدام REST API القوية. اكتشف مقاطع الفيديو المنشأة بالذكاء الاصطناعي والوسائط الاصطناعية والمحتوى المتلاعب به برمجيا.

المصادقة

تتطلب جميع طلبات API المصادقة باستخدام مفتاح API. قم بتضمين مفتاحك في رأس التفويض:

رأس التفويض

Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxx

Generate and manage your API keys from your Account Settings.

حدود المعدل

Free: 10 requests/day | Pro: 100 requests/day | Business: 1,000 requests/day | Enterprise: غير محدود

نقاط النهاية

GET /api/v1/me

احصل على معلومات حول مفتاح API الحالي وحساب المستخدم.

استجابة

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

تحليل فيديو من URL. يدعم YouTube و TikTok و Instagram و Twitter وروابط الفيديو المباشرة. كل تحليل يكلف رصيد واحد.

Request Body

Parameter	النوع	الوصف
urlمطلوب	string	عنوان URL للفيديو المراد تحليله

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

استجابة

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

استرداد نتيجة تحليل محددة بواسطة معرفها.

Path Parameters

Parameter	النوع	الوصف
idمطلوب	string	معرف التحليل المرتجع من /analyze

استجابة

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

اعرض تحليلاتك الأخيرة مع التقسيم إلى صفحات.

Query Parameters

Parameter	النوع	الوصف
pageاختياري	integer	رقم الصفحة (الافتراضي: 1)
per_pageاختياري	integer	النتائج لكل صفحة (الافتراضي: 20، الحد الأقصى: 100)

GET /api/v1/usage

احصل على إحصائيات استخدام API والحدود المتبقية.

استجابة

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

رموز الخطأ

HTTP Code	Error Code	الوصف
400	INVALID_REQUEST	نص الطلب ليس JSON صالحاً
400	MISSING_URL	معامل URL مطلوب
400	DOWNLOAD_FAILED	تعذر تنزيل الفيديو من URL
401	MISSING_AUTH	رأس التفويض مطلوب
401	INVALID_KEY	مفتاح API غير صالح
401	KEY_REVOKED	تم إلغاء مفتاح API
402	INSUFFICIENT_CREDITS	لا توجد أرصدة متبقية
429	RATE_LIMIT_EXCEEDED	تم تجاوز الحد اليومي لـ API
500	INTERNAL_ERROR	خطأ في الخادم، حاول مرة أخرى لاحقاً

تنسيق استجابة الخطأ

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

هل أنت مستعد للبدء؟

أنشئ مفتاح API الخاص بك وابدأ في اكتشاف مقاطع فيديو الذكاء الاصطناعي في دقائق.

احصل على مفتاح API الخاص بك

AiVidect Enterprise

توثيق API كشف التزييف العميق

البدء السريع

المصادقة

رأس التفويض

حدود المعدل

نقاط النهاية

استجابة

Request Body

Example Request

استجابة

Path Parameters

استجابة

Query Parameters

استجابة

رموز الخطأ

تنسيق استجابة الخطأ

هل أنت مستعد للبدء؟