Titles, topics, or hashtags

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

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

x-api-keystringRequired

This endpoint expects an object.

video_idstringRequired

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

typeslist of enumsRequired

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.

Allowed values:

The gist of the specified video has successfully been generated.

idstringOptional

Unique identifier of the response.

titlestringOptional

1	curl -X POST https://api.twelvelabs.io/v1.3/gist \
2	-H "x-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"video_id": "6298d673f1090f1100476d4c",
6	"types": [
7	"title",
8	"topic"
9	]
10	}'

1	{
2	"id": "56dd2567-9b34-4ee9-9fbb-c20fc283e5bf",
3	"title": "From Consumerism to Minimalism: A Journey Toward Sustainable Living",
4	"topics": [
5	"Shopping Vlog Lifestyle",
6	"Minimalism Lifestyle",
7	"Sustainable Living"
8	],
9	"hashtags": [
10	"#BlackFriday",
11	"#Vlog"
12	],
13	"usage": {
14	"output_tokens": 100
15	}
16	}