Skip to main content
POST
Summarize Video

POST /api/v1/summarize

Generate an AI-powered summary of video content. Supports multiple output formats including bullet points, paragraphs, and timestamped chapters.

Parameters

Response

Chapter Object (when format=chapters)

Example Request

Example Response (Chapters Format)

Example Response (Bullet Points Format)

Notes

  • Processing time varies based on video length
  • The AI analyzes both audio and visual content
  • Chapters format is ideal for creating video navigation
  • Bullet points format is concise and scannable
  • Paragraph format provides a narrative summary

Body

application/json
video_url
string<uri>
required

URL to the video to summarize

Example:

"https://example.com/video.mp4"

format
enum<string>
default:paragraph

Output format for the summary

Available options:
bullet_points,
paragraph,
chapters
Example:

"chapters"

Response

Video summarized successfully

summary
string
required

Generated summary text

Example:

"This video covers the key moments from the championship game..."

duration_sec
number
required

Duration of the video in seconds

Example:

3600

chapters
object[]

Chapter breakdown (only present when format=chapters)