AiVidect
딥페이크 탐지 API 문서
강력한 REST API로 딥페이크 탐지를 애플리케이션에 통합하세요. AI 생성 동영상, 합성 미디어, 조작된 콘텐츠를 프로그래밍 방식으로 탐지합니다.
인증
모든 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 | /analyze에서 반환된 분석 ID |
응답
{
"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."
}
}