Deepfake Detection

Analyze audio, images, and video for synthetic tampering. Submit media for detection and retrieve structured metrics and visualizations.

Request Schema

1interface DetectionRequest {
2 url: string; // publicly accessible media URL
3 callback_url?: string;
4 visualize?: boolean;
5 frame_length?: number;
6 start_region?: number;
7 end_region?: number;
8 max_video_fps?: number;
9 max_video_secs?: number;
10 intelligence?: boolean;
11 audio_source_tracing_enabled?: boolean;
12 use_ood_detector?: boolean;
13}

Response Shapes

1interface BaseDetectionResult {
2 success: true;
3 item: {
4 uuid: string;
5 created_at: string;
6 updated_at: string;
7 duration: string;
8 media_type: string;
9 status: string; // "processing" | "completed" | "failed"
10 url?: string;
11 filename?: string;
12 visualize?: boolean;
13 audio_source_tracing_enabled?: boolean;
14 use_ood_detector?: boolean;
15 pipeline?: string;
16 extra_params?: object;
17 error_message?: string;
18 intelligence?: {
19 uuid?: string;
20 description: string | IntelligenceDetails;
21 created_at: string;
22 } | null;
23 audio_source_tracing?: {
24 label: string;
25 error_message: string | null;
26 } | null;
27 };
28}
29
30interface AudioDetectionResult extends BaseDetectionResult {
31 item: BaseDetectionResult["item"] & {
32 metrics: {
33 label: string;
34 score: string[];
35 consistency: string;
36 aggregated_score: string;
37 image?: string;
38 };
39 };
40}
41
42interface ImageDetectionResult extends BaseDetectionResult {
43 item: BaseDetectionResult["item"] & {
44 image_metrics: {
45 type: string;
46 label: string;
47 image: string;
48 score: number;
49 children: any[];
50 };
51 };
52}
53
54interface VideoDetectionResult extends BaseDetectionResult {
55 item: BaseDetectionResult["item"] & {
56 metrics: AudioDetectionResult["item"]["metrics"];
57 video_metrics: {
58 label: string;
59 score: number;
60 certainty: number;
61 treeview?: string;
62 children: Array<{
63 type: string;
64 conclusion: string;
65 score: number;
66 certainty: number;
67 "certainty (%)": string;
68 children: Array<{
69 type: string;
70 conclusion: string;
71 score: number;
72 certainty: number;
73 "certainty (%)": string;
74 timestamp: number;
75 children: Array<{
76 type: string;
77 conclusion: string;
78 score: number;
79 certainty: number;
80 "certainty (%)": string;
81 }>;
82 }>;
83 }>;
84 };
85 };
86}

Use the endpoints below to submit jobs and retrieve detection results for each modality.