Create deepfake detection | Resemble

Analyze audio, image, and video for deepfake detection.

Supply media via one of three intake methods:

Direct file upload — multipart/form-data with the file attached as file. Files must be 150 MB or smaller and use one of the supported audio/video/image extensions. For larger files, use the secure upload flow.
Public URL — application/json with a url field. The API fetches the URL itself.
Secure upload token — application/json with a media_token field obtained from POST /secure_uploads.

Exactly one of file, url, or media_token must be provided per request.

Analyze audio, image, and video for deepfake detection. Supply media via one of three intake methods: - **Direct file upload** — `multipart/form-data` with the file attached as `file`. Files must be 150 MB or smaller and use one of the supported audio/video/image extensions. For larger files, use the secure upload flow. - **Public URL** — `application/json` with a `url` field. The API fetches the URL itself. - **Secure upload token** — `application/json` with a `media_token` field obtained from `POST /secure_uploads`. Exactly one of `file`, `url`, or `media_token` must be provided per request.

Authentication

AuthorizationBearer

API token from https://app.resemble.ai/account/api

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The media file to analyze (audio, video, or image). Must be 150 MB or smaller.

callback_urlstringOptionalformat: "uri"

POST destination when analysis completes

visualizebooleanOptional

Generate visualization artifacts

frame_lengthintegerOptional1-4Defaults to 2

Window size in seconds (audio/video)

start_regiondoubleOptional

Start of segment to analyze (seconds)

end_regiondoubleOptional

End of segment to analyze (seconds)

max_video_secsdoubleOptional

Cap processed duration

modalityenumOptionalDefaults to all

Video only. Selects which detection components run for a video file: audio (audio track only), video (visual frames only), or all (both — the default). Ignored for audio and image inputs. Invalid values are rejected with HTTP 400.

Allowed values:

face_onlybooleanOptionalDefaults to false

Focus visual video detection on faces by masking non-face regions. Effective only for video inputs with modality=all or modality=video. Audio, image, and modality=audio video requests are accepted but use an effective value of false.

intelligencebooleanOptionalDefaults to false

Run multimodal intelligence analysis on the media

audio_source_tracingbooleanOptionalDefaults to false

Enable audio source tracing to identify synthetic audio origin

use_reverse_searchbooleanOptionalDefaults to false

Enable reverse image search to improve detection accuracy for image files. Only applies to image detections.

use_ood_detectorbooleanOptionalDefaults to false

Enable out-of-distribution detection

zero_retention_modebooleanOptionalDefaults to false

Enable Zero Retention Mode to automatically delete submitted media after detection completes.

Response

Detection job created

successboolean

itemobject

$	curl -X POST https://app.resemble.ai/api/v2/detect \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@string

1	{
2	"success": true,
3	"item": {
4	"uuid": "string",
5	"status": "string",
6	"zero_retention_mode": true,
7	"file_deleted_at": "2024-01-15T09:30:00Z",
8	"url": "string",
9	"audio_url": "string",
10	"filename": "string",
11	"modality": "audio",
12	"face_only": true,
13	"intelligence": {
14	"description": "string",
15	"created_at": "2024-01-15T09:30:00Z"
16	}
17	}
18	}