Get Detection Result

GET https://app.resemble.ai/api/v2/detect/{uuid}

Retrieve the deepfake detection result using the provided UUID. Returns the final metrics for the detection job. Media-type-specific keys appear depending on the input.

$curl --request GET 'https://app.resemble.ai/api/v2/detect/DETECT_UUID' \
> -H 'Authorization: Bearer YOUR_API_TOKEN'

Response Details

  • metrics - Always includes a label (fake/real), score array with predictions per chunk, consistency field (for audio/video), and aggregated_score
  • image_metrics - Present for still images, contains type, label, score, visualization image (if requested), and nested analysis children
  • video_metrics - Present for videos, includes nested detections across frames with timestamps, certainty scores, and hierarchical results
  • modality - For video detects, which components were requested: audio, video, or all (default). When a single modality was requested, the skipped component’s metrics are absent (video_metrics for audio, metrics for video) and the detect still reaches completed
  • face_only - Effective face-only setting. It is true only for video detects that included visual analysis; audio, image, and audio-only video detects return false
  • audio_source_tracing - Present when audio is labeled as fake. Contains label identifying the likely source (e.g., resemble_ai, elevenlabs) or real if audio is not synthetic, and error_message (null on success)
  • intelligence - Present when intelligence analysis was requested. Contains uuid, description, created_at timestamp, and detect_uuid
  • zero_retention_mode - Boolean indicating whether Zero Retention Mode was enabled for this detect
  • file_deleted_at - ISO 8601 timestamp of when the file was purged, or null if not yet deleted. Use this to determine whether the source media has been purged from storage.
  • audio_url - Alias of url. Both are null when Zero Retention Mode is enabled
1{
2 "success": true,
3 "item": {
4 "uuid": "DETECTION_UUID",
5 "media_type": "audio",
6 "status": "completed",
7 "modality": "all",
8 "face_only": false,
9 "metrics": {
10 "label": "fake",
11 "score": ["0.9", "0.8", "0.7"],
12 "consistency": "0.85",
13 "aggregated_score": "0.566"
14 },
15 "image_metrics": {
16 "ifl": {
17 "score": 1,
18 "heatmap": "https://..."
19 },
20 "type": "FinalResult",
21 "label": "Fake",
22 "image": "https://...",
23 "score": 1,
24 "children": []
25 },
26 "video_metrics": {
27 "label": "Fake",
28 "score": "0.9",
29 "certainty": "0.9",
30 "treeview": "...",
31 "children": [
32 {
33 "type": "VideoResult",
34 "conclusion": "Fake",
35 "score": "0.99",
36 "certainty": "0.9",
37 "children": [
38 {
39 "type": "ImageResult",
40 "conclusion": "Fake",
41 "score": "0.9",
42 "certainty": "0.95",
43 "timestamp": "0.23",
44 "children": [
45 {
46 "type": "Segment",
47 "conclusion": "Fake",
48 "score": "0.9",
49 "certainty": "0.995"
50 }
51 ]
52 }
53 ]
54 }
55 ]
56 },
57 "audio_source_tracing": {
58 "label": "resemble_ai",
59 "error_message": null
60 },
61 "intelligence": {
62 "uuid": "INTELLIGENCE_UUID",
63 "description": "Adult male speaker with confident tone discussing...",
64 "created_at": "2024-01-15T10:30:05Z",
65 "detect_uuid": "DETECTION_UUID"
66 },
67 "url": "https://storage.example.com/audio/suspicious.wav",
68 "audio_url": "https://storage.example.com/audio/suspicious.wav",
69 "filename": "suspicious.wav",
70 "duration": 8.2,
71 "zero_retention_mode": false,
72 "file_deleted_at": null,
73 "created_at": "2024-01-15T10:30:00Z",
74 "updated_at": "2024-01-15T10:30:05Z"
75 }
76}
  • metrics always reflects the aggregate prediction and confidence per chunk.
  • image_metrics appears for still images and contains visualization assets if requested.
  • video_metrics nests detections across frames with timestamps and certainty percentages.
  • audio_source_tracing is only returned when audio is labeled as fake. Use the standalone Audio Source Tracing endpoints to access all source tracing reports.

Zero Retention Mode Response

When zero_retention_mode was enabled on the original request, media URLs are redacted and the filename is tokenized:

1{
2 "success": true,
3 "item": {
4 "uuid": "DETECTION_UUID",
5 "media_type": "audio",
6 "status": "completed",
7 "face_only": false,
8 "metrics": {
9 "label": "fake",
10 "score": ["0.9", "0.8", "0.7"],
11 "consistency": "0.85",
12 "aggregated_score": "0.566"
13 },
14 "url": null,
15 "audio_url": null,
16 "filename": "redacted_abc123def4567890abcd1234.wav",
17 "duration": 8.2,
18 "zero_retention_mode": true,
19 "file_deleted_at": "2024-01-15T10:31:00Z",
20 "created_at": "2024-01-15T10:30:00Z",
21 "updated_at": "2024-01-15T10:30:05Z"
22 }
23}

Error Response (404)

1{
2 "success": false,
3 "message": "Detect not found"
4}