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
    • Index content
    • Manage videos
      • The video object
      • GETList videos
      • GETRetrieve video information
      • PATCHPartial update video information
      • DELDelete video information
    • Manage entities
    • Any-to-video search
    • Create embeddings v2
    • Create embeddings v1
    • Analyze and segment videos
    • Error codes
LogoLogo
Sample appsIntegrationsDiscordPlaygroundDevEx repo
API ReferenceManage videos

The video object

Was this page helpful?
Previous

List videos

Next
Built with

The video object has the following fields:

  • _id: A string representing the unique identifier of a video. The platform creates a new video object and assigns it a unique identifier when the video has been indexed. Note that video IDs are different from task IDs.
  • created_at: A string indicating the date and time, in the RFC 3339 format, that the video indexing task was created.
  • indexed_at: A string indicating the date and time, in the RFC 3339 format, that the video has finished indexing.
  • system_metadata: An object that contains system-generated metadata about the video. It contains the following fields:
    • duration
    • filename
    • fps
    • height
    • model_names
    • size
    • video_title
    • width
  • user_metadata: Any custom metadata you’ve specified by calling the PUT method of the /indexes/:index-id/videos/:video-id endpoint.
  • hls: The platform returns this object only for the videos that you uploaded with the enable_video_stream parameter set to true. This object has the following fields:
    • video_url: A string representing the URL of the video. You can use this URL to access the stream over the HLS protocol.
    • thumbnail_urls: An array containing the URL of the thumbnail.
    • status: A string representing the encoding status of the video file from its original format to a streamable format.
    • updated_at: A string indicating the date and time, in the RFC 3339 format, that the encoding status was last updated.
  • updated_at: A string indicating the date and time, in the RFC 3339 format, that the video indexing task object was last updated. The platform updates this field every time the video indexing task transitions to a different state.