API ReferenceUpload content

Direct uploads

Upload videos, images, and audio files to the TwelveLabs platform. Direct uploads are processed asynchronously - you initiate the upload and monitor its status until the asset is ready.

Workflow

1

Upload your file using the POST method of the /assets endpoint. You receive the asset ID in the response.

2

Monitor the indexing status using the GET method of the /indexes/{index-id}/indexed-assets/{indexed-asset-id} endpoint until it’s ready.

3

What you do next depends on your use case:

  • For creating embeddings (videos, audio, images): Use the asset ID with the Embed API v2.
  • For entity search (images): Use the asset ID to create entities.
  • For search and analysis (videos): Index your asset using the asset ID.

You can upload once and reuse the same asset in different indexes or workflows.