> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bota.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Video Summary

> Generate a visual summary from video clips with key frames and captions

<Info>
  This feature is **Coming Soon** and not yet available.
</Info>

## Overview

Generates a visual summary from video media captured during a recording. The system identifies key frames, generates captions for each, and produces a timeline of visual highlights alongside the audio narrative.

Useful for quickly reviewing long recordings — see the most important visual moments without watching the entire video.

## Authentication

Requires a valid API key with `video_summaries:write` scope.

## Request Body

<ParamField body="recording_id" type="string" required>
  Recording ID with uploaded video media (`rec_*`)
</ParamField>

<ParamField body="media_ids" type="string[]">
  Specific video media IDs to summarize. If omitted, all video media is processed.
</ParamField>

<ParamField body="max_keyframes" type="integer">
  Maximum number of key frames to extract per video. Default: `10`.
</ParamField>

<ParamField body="include_transcript_context" type="boolean">
  Whether to correlate key frames with transcript segments. Default: `true`.
</ParamField>

## Response

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "vs_abc123",
    "recording_id": "rec_abc123",
    "status": "pending",
    "media_count": 3,
    "created_at": "2025-01-15T11:00:00Z"
  }
  ```

  ```json 422 theme={null}
  {
    "error": {
      "code": "validation_error",
      "message": "Recording has no uploaded video media"
    }
  }
  ```
</ResponseExample>