The TwelveLabs class

The TwelveLabs class is the main entry point for the SDK. It initializes the client and provides access to resources for uploading videos, managing indexes, performing searches, creating embeddings, and analyzing videos.

Methods

The initializer

Description: The constructor creates a new instance of the TwelveLabs class.

Function signature and example:

1 def __init__(
2     self,
3     *,
4     api_key: typing.Optional[str] = None,
5     **kwargs,
6 )

Parameters

Name	Type	Required	Description
`api_key`	`typing.Optional[str]`	Yes	Your TwelveLabs API key. If not provided, the `TWELVE_LABS_API_KEY` environment variable will be used.
`**kwargs`	`dict`	No	Additional parameters to pass to the base client. You can pass a variable named `timeout` of type `float` to set the request timeout in seconds. The default timeout is 600 seconds, unless you use a custom `httpx` client. For long-running endpoints (`embed` or `analyze` with large inputs), pass a higher value. For fast-fail behavior, pass a lower value, or override per call via `request_options={"timeout_in_seconds": N}`.

Return value

None. This method initializes the instance.

1	def __init__(
2	self,
3	*,
4	api_key: typing.Optional[str] = None,
5	**kwargs,
6	)