Direct uploads
Upload videos, images, and audio files to the TwelveLabs platform. This method creates an asset that you can use in different workflows.
The platform processes files up to 200 MB synchronously and sets the asset status to ready. For files larger than 200 MB, the platform processes the upload asynchronously. Check the asset status until it is ready before using the asset.
Workflow
Upload your file using the POST method of the /assets endpoint. You receive the asset ID in the response.
(Optional) For files 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.
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.
