Upload a media file | AssemblyAI

Upload a media file to AssemblyAI’s servers.

To upload a media file to our EU server, replace api.assemblyai.com with api.eu.assemblyai.com.

Requests to transcribe uploaded files must use an API key from the same project as the key that was used to upload the file. If you use an API key from a different project you will get a 403 error and “Cannot access uploaded file” message.

Upload a media file to AssemblyAI's servers. <Note>To upload a media file to our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.</Note> <Warning>Requests to transcribe uploaded files must use an API key from the same project as the key that was used to upload the file. If you use an API key from a different project you will get a `403` error and "Cannot access uploaded file" message.</Warning>

Authentication

Authorizationstring

API Key authentication via header

Request

This endpoint expects binary data of type application/octet-stream.

Response

Media file uploaded successfully

upload_urlstringformat: "url"

A URL that points to your audio file, accessible only by AssemblyAI's servers

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

504

Gateway Timeout Error

1	curl -X POST https://api.assemblyai.com/v2/upload \
2	-H "Authorization: <apiKey>" \
3	-H "Content-Type: application/octet-stream" \
4	--data-binary @path/to/file