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