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 a batch deepfake detection job

POST
https://app.resemble.ai/api/v2/detect/batch
POST
/api/v2/detect/batch
$curl -X POST https://app.resemble.ai/api/v2/detect/batch \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: multipart/form-data" \
>     -F file=@<file1>
1{
2  "success": true,
3  "item": {
4    "uuid": "string",
5    "status": "processing",
6    "total_files": 1,
7    "completed_count": 1,
8    "failed_count": 1,
9    "created_at": "2024-01-15T09:30:00Z",
10    "detect_uuids": [
11      "string"
12    ]
13  }
14}
Submit up to 50 files in a single request and process them as a single logical group. Returns HTTP 202 with a batch UUID; each file is analyzed in the background and individual results are available via `GET /detect/{uuid}` for each entry in `detect_uuids`. Two intake methods: - **Multiple media files** — repeated `files[]` form fields. - **Single zip archive** — a single `file` form field whose value is a `.zip` containing the media files. Non-media entries are skipped. Provide one of `files[]` or `file=<...>.zip` per request. Synchronous mode (`Prefer: wait`) is not supported and returns 400 if sent. Constraints: - Maximum 50 files per batch. - Maximum 500 MB total upload size across all files. - Allowed file types match `POST /detect`'s direct-upload allowlist. - All-or-nothing billing: if the team's wallet cannot cover the projected cost for every file, the request is rejected with 402 and no detects are created.
Was this page helpful?
Previous

Get batch status

Next
Built with

Submit up to 50 files in a single request and process them as a single logical group. Returns HTTP 202 with a batch UUID; each file is analyzed in the background and individual results are available via GET /detect/{uuid} for each entry in detect_uuids.

Two intake methods:

  • Multiple media files — repeated files[] form fields.
  • Single zip archive — a single file form field whose value is a .zip containing the media files. Non-media entries are skipped.

Provide one of files[] or file=<...>.zip per request. Synchronous mode (Prefer: wait) is not supported and returns 400 if sent.

Constraints:

  • Maximum 50 files per batch.
  • Maximum 500 MB total upload size across all files.
  • Allowed file types match POST /detect’s direct-upload allowlist.
  • All-or-nothing billing: if the team’s wallet cannot cover the projected cost for every file, the request is rejected with 402 and no detects are created.

Authentication

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

Request

This endpoint expects a multipart form with multiple files.
files[]filesOptional

One or more media files. Repeat the files[] field for each file. Mutually exclusive with file.

filefileOptional

A single .zip archive containing media files. Mutually exclusive with files[].

callback_urlstringOptionalformat: "uri"
POST destination invoked when the batch reaches a terminal state.
intelligencebooleanOptionalDefaults to false
Run multimodal intelligence on every file in the batch.
search_identitybooleanOptionalDefaults to false

Run identity search against the team’s saved identities (audio/video only).

visualizebooleanOptionalDefaults to true
Generate visualization artifacts.
audio_source_tracing_enabledbooleanOptionalDefaults to false
Enable audio source tracing on each audio file.
frame_lengthintegerOptional1-4

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 video duration.
use_llmbooleanOptional

Use LLM-assisted video analysis.

zero_retention_modebooleanOptionalDefaults to false
Enable Zero Retention Mode for every file in the batch.

Response

Batch accepted
successboolean
itemobject

Aggregate state for a batch detection job. Returned by POST /detect/batch and GET /detect/batch/{uuid}.

Errors

400
Bad Request Error
402
Payment Required Error
403
Forbidden Error

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