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