API ReferenceUpload content

Direct uploads

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

Workflow

1

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

2

For URL uploads larger than 200 MB, check the asset status using the GET method of the /assets/{asset-id} endpoint until the status field is ready before proceeding.

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.