Titles, topics, or hashtags

This endpoint generates concise overviews in the form of titles, topics, and hashtags representing 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 for which you want to generate a gist.

typeslist of enumsRequired

An array specifying the type of text the platform must generate. Use one or more of the following values:

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.
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.

Allowed values:

The gist has successfully been generated.

idstringOptional

Unique identifier of the response.

titlestringOptional

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

1	{
2	"id": "bc213924-fa97-4af6-9ca2-3212f419d1e6",
3	"title": "A Day in My Life: Graduation, Moving Home, Shopping Hauls, Cooking, and Outdoor Adventures!",
4	"topics": [
5	"Lifestyle Vlog"
6	],
7	"hashtags": [
8	"graduation",
9	"moving",
10	"home",
11	"shopping",
12	"hauls",
13	"cooking",
14	"outdoor",
15	"adventures",
16	"lifestyle",
17	"vlog"
18	]
19	}