API ReferenceAnalyze videos

Open-ended texts

Deprecated
This endpoint is deprecated. Use the /analyze endpoint instead, which provides identical functionality.

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 Open-ended analysis guide.

Headers

x-api-keystringRequired

Request

Request to generate a text representation of a video.
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 2,000 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.
Streamed responseobject
OR
Non-streamed responseobject

Errors