> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.twelvelabs.io/v1.3/sdk-reference/python/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server. # Python SDK > Python SDK for the TwelveLabs Video Understanding Platform. The [TwelveLabs Python SDK](https://github.com/twelvelabs-io/twelvelabs-python) provides a robust interface for interacting with the TwelveLabs Video Understanding Platform. It simplifies authentication and efficiently processes asynchronous tasks. > **Notes** > > * This section provides an overview of the key methods and their usage. However, it is a partial list of all available methods and fields in the SDK. > * The SDK is designed to closely follow the structure of the TwelveLabs API. In most cases, you'll find a corresponding method in the SDK for each method in the API. # Sample applications To get started quickly, see the sample applications below that demonstrate the capabilities of the TwelveLabs Python SDK. These applications show how to implement common use cases and the best practices for using the SDK. * [Building an Olympic Video Classification Application with TwelveLabs](https://www.twelvelabs.io/blog/olympics-classification) > Python SDK for the TwelveLabs Video Understanding Platform. ## Docs - [The TwelveLabs class](https://docs.twelvelabs.io/sdk-reference/python/the-twelve-labs-class.md): Initialize the Python SDK client. - [Assets](https://docs.twelvelabs.io/sdk-reference/python/assets.md): Upload, manage, and import assets with the Python SDK. - [Upload content](https://docs.twelvelabs.io/sdk-reference/python/upload-files.md): Upload videos, images, audio, and documents to create reusable assets. - [Direct uploads](https://docs.twelvelabs.io/sdk-reference/python/upload-files/direct-uploads.md): Upload files directly to the platform. Processing is asynchronous; poll the asset status until it is ready. - [Multipart uploads](https://docs.twelvelabs.io/sdk-reference/python/upload-files/multipart-uploads.md): Upload local video, audio, and images in chunks for reliable, resumable transfers. - [Manage assets](https://docs.twelvelabs.io/sdk-reference/python/manage-assets.md): Retrieve assets, manage user-defined metadata, and retrieve transcriptions. - [Data connectors](https://docs.twelvelabs.io/sdk-reference/python/data-connectors.md): Connect external data providers and manage connections with the Python SDK. - [Imports](https://docs.twelvelabs.io/sdk-reference/python/data-connectors/imports.md): Import files from a connected account with the Python SDK. - [Manage entities](https://docs.twelvelabs.io/sdk-reference/python/manage-entities.md): Manage your entities and entity collections. - [Agents (Research preview)](https://docs.twelvelabs.io/sdk-reference/python/agents.md): Agentic orchestration with knowledge stores and persistent memory. - [Knowledge stores](https://docs.twelvelabs.io/sdk-reference/python/knowledge-stores.md): Create and manage knowledge stores with the Python SDK. - [Search a knowledge store](https://docs.twelvelabs.io/sdk-reference/python/search-knowledge-store.md): Search across the items in a knowledge store with the Python SDK. - [Knowledge store items](https://docs.twelvelabs.io/sdk-reference/python/knowledge-store-items.md): Add items to a knowledge store and organize them into collections with the Python SDK. - [Responses](https://docs.twelvelabs.io/sdk-reference/python/responses.md): Reason over a knowledge store and generate responses with the Python SDK. - [Models and search](https://docs.twelvelabs.io/sdk-reference/python/models-and-search.md): Index content, search videos, create embeddings, and analyze videos with the Python SDK. - [Manage indexes](https://docs.twelvelabs.io/sdk-reference/python/manage-indexes.md): Create and manage indexes for organizing video embeddings and metadata. - [Index content](https://docs.twelvelabs.io/sdk-reference/python/index-content.md): Manage the indexed assets within an index. - [Manage videos](https://docs.twelvelabs.io/sdk-reference/python/manage-videos.md): This API will be deprecated in a future version. Use the Index content API. - [Video indexing tasks](https://docs.twelvelabs.io/sdk-reference/python/video-indexing-tasks.md): This method of uploading videos will be deprecated in a future version. Use direct uploads or multipart uploads followed by separate indexing. - [Search](https://docs.twelvelabs.io/sdk-reference/python/search.md): Perform search requests. - [Create embeddings v2](https://docs.twelvelabs.io/sdk-reference/python/create-embeddings-v-2.md): Create vector embeddings for text, images, audio, video, and documents. Enable semantic search and content understanding. - [Create sync embeddings](https://docs.twelvelabs.io/sdk-reference/python/create-embeddings-v-2/create-sync-embeddings.md): Create embeddings synchronously. - [Create async embeddings](https://docs.twelvelabs.io/sdk-reference/python/create-embeddings-v-2/create-async-embeddings.md): Create embeddings asynchronously for audio, video, images, and documents. - [Create embeddings v1](https://docs.twelvelabs.io/sdk-reference/python/create-embeddings-v-1.md): This API will be deprecated in a future version. Migrate to the Embed API v2 for continued support and access to new features. - [Create text, image, and audio embeddings](https://docs.twelvelabs.io/sdk-reference/python/create-embeddings-v-1/create-text-image-and-audio-embeddings.md): Create text, image, and audio embeddings. - [Create video embeddings](https://docs.twelvelabs.io/sdk-reference/python/create-embeddings-v-1/create-video-embeddings.md): Create embeddings for your videos. - [Analyze and segment videos](https://docs.twelvelabs.io/sdk-reference/python/analyze-videos.md): Analyze videos to generate text and extract structured, timestamped segments. - [Sync analysis](https://docs.twelvelabs.io/sdk-reference/python/analyze-videos/sync-analysis.md) - [Async analysis](https://docs.twelvelabs.io/sdk-reference/python/analyze-videos/async-analysis.md) - [Batch analysis](https://docs.twelvelabs.io/sdk-reference/python/analyze-videos/batch-analysis.md)