Create a batch deepfake detection job | Resemble

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.

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

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.

1	curl -X POST https://app.resemble.ai/api/v2/detect/batch \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: multipart/form-data" \
4	-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	}