Upload files

Upload your videos, images, and audio files to the TwelveLabs platform. Uploading creates an asset that you can then use in different workflows.

Depending on your requirements, choose one of the methods below.

To import files from your users’ Google Drive accounts, use Data connectors.

Direct uploads

Upload whole files in a single request.

Supported content: Video, audio, and images.

Use this method when:

  • You want to upload a file in a single request
  • You are uploading images (multipart uploads apply the same 32 MB limit)
  • You are uploading a file from a URL (multipart uploads support only local files)
  • Your files are small enough that chunking adds no benefit

Upload limits:

  • Video and audio, local files: Up to 200 MB
  • Video and audio, public URLs: Up to 4 GB
  • Images: Up to 32 MB

Multipart uploads

Upload files as multiple chunks processed in parallel.

Supported content: Video, audio, and images.

Use this method when:

  • You need to upload a larger local video or audio file
  • You need automatic retry on failure
  • You need improved reliability, performance, or observability
  • You want to track upload progress
  • You want parallel chunk uploads for faster performance

Upload limits:

  • Video and audio, local files: Up to 10 GB
  • Images: Up to 32 MB