Deepfake Detection

1
interface 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?: boolean;
12
  use_ood_detector?: boolean;
13
  privacy_mode?: boolean;
14
}

1
interface 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
    audio_url?: string; // alias of url
12
    filename?: string;
13
    privacy_mode: boolean;
14
    media_redacted: boolean;
15
    media_deleted: boolean;
16
    file_deleted_at: string | null;
17
    visualize?: boolean;
18
    audio_source_tracing_enabled?: boolean;
19
    use_ood_detector?: boolean;
20
    pipeline?: string;
21
    extra_params?: object;
22
    error_message?: string;
23
    intelligence?: {
24
      uuid?: string;
25
      description: string | IntelligenceDetails;
26
      created_at: string;
27
    } | null;
28
    audio_source_tracing?: {
29
      label: string;
30
      error_message: string | null;
31
    } | null;
32
  };
33
}
34
35
interface AudioDetectionResult extends BaseDetectionResult {
36
  item: BaseDetectionResult["item"] & {
37
    metrics: {
38
      label: string;
39
      score: string[];
40
      consistency: string;
41
      aggregated_score: string;
42
      image?: string;
43
    };
44
  };
45
}
46
47
interface ImageDetectionResult extends BaseDetectionResult {
48
  item: BaseDetectionResult["item"] & {
49
    image_metrics: {
50
      type: string;
51
      label: string;
52
      image: string;
53
      score: number;
54
      children: any[];
55
    };
56
  };
57
}
58
59
interface VideoDetectionResult extends BaseDetectionResult {
60
  item: BaseDetectionResult["item"] & {
61
    metrics: AudioDetectionResult["item"]["metrics"];
62
    video_metrics: {
63
      label: string;
64
      score: number;
65
      certainty: number;
66
      treeview?: string;
67
      children: Array<{
68
        type: string;
69
        conclusion: string;
70
        score: number;
71
        certainty: number;
72
        "certainty (%)": string;
73
        children: Array<{
74
          type: string;
75
          conclusion: string;
76
          score: number;
77
          certainty: number;
78
          "certainty (%)": string;
79
          timestamp: number;
80
          children: Array<{
81
            type: string;
82
            conclusion: string;
83
            score: number;
84
            certainty: number;
85
            "certainty (%)": string;
86
          }>;
87
        }>;
88
      }>;
89
    };
90
  };
91
}