For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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 for the detection result.
wait_for_intelligencebooleanOptional
Controls callback timing when callback_url and intelligence=true are provided. True waits without a forced timeout until Detect and Intelligence are both finished. False sends after Detect finishes without waiting for Intelligence. When omitted, the callback waits up to 10 minutes for Intelligence before sending the result state available at that time.
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
infer_from_intelligencebooleanOptionalDefaults to false
Opt in to let a strong intelligence finding escalate an otherwise non-fake verdict to “Likely Fake”. Has no effect unless intelligence is also true.
audio_source_tracingbooleanOptionalDefaults to false
Enable audio source tracing to identify synthetic audio origin
signalbooleanOptionalDefaults to false
Run Signal content analysis after detection completes, classifying the media against fraud and abuse categories. Requires Signal access on your plan and cannot be combined with zero_retention_mode. Not supported for batch detections.
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
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.
