Upload media securely | Resemble

Upload a media file and receive a short-lived token that can be passed to downstream endpoints (such as `/detect` and `/intelligence`) in place of a public URL. The returned token is a JWT that expires 1 hour after issuance. Keeping uploads private avoids exposing source media on the open internet and means you do not need to host files yourself for jobs that only need the API to read them once.

Upload a media file and receive a short-lived token that can be passed to downstream endpoints (such as /detect and /intelligence) in place of a public URL. The returned token is a JWT that expires 1 hour after issuance.

Keeping uploads private avoids exposing source media on the open internet and means you do not need to host files yourself for jobs that only need the API to read them once.

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 upload (audio, image, or video).

Response

Upload accepted

successboolean

tokenstring

JWT referencing the uploaded file. Valid for 1 hour. Pass this value as media_token on downstream requests.

Errors

400

Bad Request Error

401

Unauthorized Error

Keeping uploads private avoids exposing source media on the open internet and means you do not need to host files yourself for jobs that only need the API to read them once.

This endpoint expects a multipart form containing a file.

The media file to upload (audio, image, or video).

JWT referencing the uploaded file. Valid for 1 hour. Pass this value as media_token on downstream requests.

$	curl -X POST https://app.resemble.ai/api/v2/secure_uploads \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@string

$	curl -X POST https://app.resemble.ai/api/v2/secure_uploads \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@string