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