Titles, topics, and hashtags

post

https://api.twelvelabs.io/v1.3/gist

This endpoint generates titles, topics, and hashtags for your videos. Those are representations of the key elements or themes of a video.

NOTE: This endpoint is rate-limited. For details, see the Rate limits page.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request to generate a gist for a video.

video_id

string

required

The unique identifier of the video that you want to generate a gist for.

types

array of strings

required

Specifies the type of gist. Use one of the following values:

title: A title succinctly captures a video's main theme, such as "From Consumerism to Minimalism: A Journey Toward Sustainable Living," guiding viewers to its content and themes.
topic: A topic is the central theme of a video, such as "Shopping Vlog Lifestyle", summarizing its content for efficient categorization and reference.
hashtag: A hashtag, like "#BlackFriday", represents key themes in a video, enhancing its discoverability and categorization on social media platforms.

types*

Allowed:

Headers

x-api-key

string

required

Your API key.

NOTE: You can find your API key on the API Key page.

Responses

429

If the rate limit is reached, the platform returns an HTTP 429 - Too many requests error response. The response body is empty.

200The gist of the specified video has successfully been generated.