The Resources.Generate class provides methods to generate various types of text content from videos.

Titles, topics, and hashtags

Description: This method generates titles, topics, and hashtags for a specific video. It uses predefined formats and doesn’t require a custom prompt, and it’s best for generating immediate and straightforward text representations without specific customization.

Function signature and example:

1
async gist(
2
  videoId: string,
3
  types: GenerateGistType[],
4
  options: RequestOptions = {},
5
): Promise<Models.GenerateGistResult> 

Parameters:

Return value: Returns a Promise that resolves to a Models.GenerateGistResult instance.

API Reference: For a description of each field in the request and response, see the Generate topics, titles, and hashtags page.

Related guide: Titles, topics, and hashtags.

Summaries, chapters, and highlights

Description: This method generates summaries, chapters, or highlights for your videos. Optionally, you can provide a prompt to customize the output.

Function signature and example:

1
async summarize(
2
  videoId: string,
3
  type: GenerateSummarizeType,
4
  prompt?: string,
5
  temperature?: number,
6
  options: RequestOptions = {},
7
): Promise<Models.GenerateSummarizeResult>

Parameters:

Return value: Returns a Promise that resolves to a Models.GenerateSummarizeResult instance.

API Reference: For a description of each field in the request and response, see the Generate summaries, chapters, and highlights page.

Related guide: Summaries, chapters, and highlights.

Open-ended text

Description: This method generates open-ended texts based on your videos.

Function signature and example:

1
async text(
2
  videoId: string,
3
  prompt: string,
4
  temperature?: number,
5
  options: RequestOptions = {},
6
): Promise<Models.GenerateOpenEndedTextResult>

Parameters:

Return value: Returns a Promise that resolves to a Models.GenerateOpenEndedTextResult instance.

API Reference: For a description of each field in the request and response, see the Open-ended text page.

Related guide: Open-ended text .

Open-ended text with streaming responses

Description: This method generates open-ended texts and supports streaming responses.

Function signature and example:

1
async textStream(
2
  { videoId, prompt, temperature }: GenerateTextStreamParams,
3
  options: RequestOptions = {},
4
): Promise<Models.GenerateTextStreamResult>

Parameters:

The GenerateTextStreamParams interface defines the parameters for streaming text generated based on video content:

API Reference: For a description of each field in the request and response, see the Open-ended text page.

Related guide: Streaming responses.