AiVidect AiVidect Enterprise

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

Documentacao de API de Deteccao de Deepfake

Integre a deteccao de deepfake em seu aplicativo com nossa poderosa API REST. Detecte videos gerados por IA, midia sintetica e conteudo 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"}'
Obtenha sua chave API

Autenticacao

Todas as solicitacoes de API requerem autenticacao usando uma chave API. Inclua sua chave no cabecalho Authorization:

Cabecalho de Autorizacao

Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxx

Generate and manage your API keys from your Account Settings.

Limites de Taxa

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

Endpoints

GET /api/v1/me

Obtenha informacoes sobre a chave API atual e a conta do usuario.

Resposta

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

Analisar um video de URL. Suporta YouTube, TikTok, Instagram, Twitter e links de video diretos. Cada analise custa 1 credito.

Request Body

Parameter Tipo Descricao
urlobrigatório string URL do video a analisar

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

Resposta

{ "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 um resultado de analise especifico pelo seu ID.

Path Parameters

Parameter Tipo Descricao
idobrigatório string O ID de analise retornado de /analyze

Resposta

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

Liste suas análises recentes com paginação.

Query Parameters

Parameter Tipo Descricao
pageopcional integer Número da página (padrão: 1)
per_pageopcional integer Resultados por página (padrão: 20, máx: 100)
GET /api/v1/usage

Obtenha estatísticas de uso da API e limites restantes.

Resposta

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

HTTP Code Error Code Descricao
400 INVALID_REQUEST O corpo da solicitação não é JSON válido
400 MISSING_URL O parâmetro URL é obrigatório
400 DOWNLOAD_FAILED Não foi possível baixar o vídeo da URL
401 MISSING_AUTH O cabeçalho de autorização é obrigatório
401 INVALID_KEY A chave API é inválida
401 KEY_REVOKED A chave API foi revogada
402 INSUFFICIENT_CREDITS Sem créditos restantes
429 RATE_LIMIT_EXCEEDED Limite diário da API excedido
500 INTERNAL_ERROR Erro do servidor, tente novamente mais tarde

Formato de Resposta de Erro

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

Pronto para Começar?

Gere sua chave API e comece a detectar vídeos de IA em minutos.

Obtenha Sua Chave API