For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Status
OverviewProductsManageAPI ReferenceTutorialsClient Libraries
OverviewProductsManageAPI ReferenceTutorialsClient Libraries
  • API Reference
      • GETList all detects
      • POSTCreate deepfake detection
      • GETGet deepfake detection result
      • POSTCreate a batch deepfake detection job
      • GETGet batch status
Status
LogoLogo
API ReferenceDeepfake Detection

Create deepfake detection

POST
https://app.resemble.ai/api/v2/detect
POST
/api/v2/detect
$curl -X POST https://app.resemble.ai/api/v2/detect \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: multipart/form-data" \
> -F file=@string
200Successful
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}
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.
Was this page helpful?
Previous

Get deepfake detection result

Next
Built with

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

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