For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sample appsIntegrationsDiscordPlaygroundDevEx repo
GuidesSDK ReferenceAPI Reference
GuidesSDK ReferenceAPI Reference
  • TwelveLabs API
    • Introduction
    • Authentication
  • API Reference
    • Manage indexes
    • Upload content
      • Direct uploads
        • POSTCreate an asset
        • GETRetrieve an asset
        • GETList assets
        • DELDelete an asset
        • PATCHUpdate the user-defined metadata of an asset
        • DELDelete the user-defined metadata of an asset
      • Multipart uploads
      • Video indexing tasks
    • Index content
    • Manage videos
    • Manage entities
    • Any-to-video search
    • Create embeddings v2
    • Create embeddings v1
    • Analyze and segment videos
    • Error codes
LogoLogo
Sample appsIntegrationsDiscordPlaygroundDevEx repo
On this page
  • Workflow
API ReferenceUpload content

Direct uploads

Was this page helpful?
Previous

Create an asset

Next
Built with

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.