API ReferenceGenerate text from video

Open-ended texts

This endpoint generates open-ended texts based on your videos, including but not limited to tables of content, action items, memos, and detailed analyses.

Notes
  • This endpoint is rate-limited. For details, see the Rate limits page.
  • This endpoint supports streaming responses. For details on integrating this feature into your application, refer to the Streaming response guide.

Headers

x-api-keystringRequired

Request

This endpoint expects an object.
video_idstringRequired

The unique identifier of the video for which you wish to generate a text.

promptstringRequired

A prompt that guides the model on the desired format or content.

Notes
  • Even though the model behind this endpoint is trained to a high degree of accuracy, the preciseness of the generated text may vary based on the nature and quality of the video and the clarity of the prompt.
  • Your prompts can be instructive or descriptive, or you can also phrase them as questions.
  • The maximum length of a prompt is 375 tokens.

Examples:

  • Based on this video, I want to generate five keywords for SEO (Search Engine Optimization).
  • I want to generate a description for my video with the following format: Title of the video, followed by a summary in 2-3 sentences, highlighting the main topic, key events, and concluding remarks.
temperaturedoubleOptional

Controls the randomness of the text output generated by the model. A higher value generates more creative text, while a lower value produces more deterministic text output.

Default: 0.2 Min: 0 Max: 1

streambooleanOptionalDefaults to true

Set this parameter to true to enable streaming responses in the NDJSON format.

Default: true

Response

The specified video has successfully been processed.

Stream Generate Responseobject
OR
Non Stream Generate Responseobject

Errors