Skip to main content
POST
Upload File
Upload a media file to create a new Asset. The returned id can be used as assetId when creating a Task.
Maximum file size is 2GB. Uploaded Assets expire after 72 hours.
The β€œTry it” tool on this page has a 5MB upload limit. To upload larger files, use the API directly via curl, Python, or your preferred HTTP client.

Authorizations

x-api-key
string
header
required

Body

multipart/form-data
file
file
required

The uploaded file data. Supported audio formats only. (e.g. wav, aiff, flac, mp3). The multipart file part must declare the file's real MIME type (e.g. audio/wav) β€” clients that default to application/octet-stream are rejected with 400 "File upload failed", and a missing type can cause the format to be misdetected. With curl: -F 'file=@input.wav;type=audio/wav'.

Response

200 - application/json

Default Response

id
string

Unique identifier of the Asset. Use this id as assetId when creating a Task.

format
string

Format of the output file

name
string

Name of the Asset