AiVidect AiVidect Enterprise

English English Español Spanish Português Portuguese Français French Deutsch German العربية Arabic हिन्दी Hindi 日本語 Japanese 한국어 Korean 中文 Chinese Русский Russian
Войти Попробовать Детектор Дипфейков Бесплатно

Документация API Обнаружения Дипфейков

Интегрируйте обнаружение дипфейков в ваше приложение с помощью нашего мощного REST API. Программно обнаруживайте ИИ-видео, синтетические медиа и манипулированный контент.

Быстрый Старт

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"}'
Получите свой API ключ

Аутентификация

Все API-запросы требуют аутентификации с использованием API-ключа. Включите ваш ключ в заголовок Authorization:

Заголовок Авторизации

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 и прямые ссылки на видео. Каждый анализ стоит 1 кредит.

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}

Получить конкретный результат анализа по его ID.

Path Parameters

Parameter Тип Описание
idобязательно string ID анализа, возвращенный из /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-Ключ