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

model_typesenumOptional

Use talking_head for face-swaps

Allowed values:

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

1	curl -X POST https://app.resemble.ai/api/v2/detect \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: multipart/form-data" \
4	-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	"intelligence": {
12	"description": "string",
13	"created_at": "2024-01-15T09:30:00Z"
14	}
15	}
16	}