Interface VideoAnalysisProgressEvent

Progress event emitted during video analysis.

The analysis lifecycle flows through these phases in order: extracting-frames -> detecting-scenes -> describing -> transcribing -> summarizing.

interface VideoAnalysisProgressEvent {
    phase: "transcribing" | "extracting-frames" | "detecting-scenes" | "describing" | "summarizing";
    progress?: number;
    currentScene?: number;
    message?: string;
}

Properties

phase: "transcribing" | "extracting-frames" | "detecting-scenes" | "describing" | "summarizing"

Current phase of the analysis pipeline.

  • 'extracting-frames' — Decoding video and extracting frames
  • 'detecting-scenes' — Running scene boundary detection
  • 'describing' — Sending key frames to vision LLM
  • 'transcribing' — Running audio transcription via Whisper
  • 'summarizing' — Generating overall video summary
progress?: number

Estimated progress percentage (0-100) within the current phase. Not always available — depends on the phase and provider.

currentScene?: number

0-based index of the scene currently being processed. Only meaningful during the 'describing' and 'transcribing' phases.

message?: string

Human-readable status message for the current phase.