Skip to main content

Interface: AnalyzeVideoOptions

Defined in: packages/agentos/src/api/analyzeVideo.ts:35

Options for a analyzeVideo call.

At minimum, a video source (videoUrl or videoBuffer) is required.

Properties​

descriptionDetail?​

optional descriptionDetail: DescriptionDetail

Defined in: packages/agentos/src/api/analyzeVideo.ts:72

How detailed scene descriptions should be.

Default​

'detailed'

indexForRAG?​

optional indexForRAG: boolean

Defined in: packages/agentos/src/api/analyzeVideo.ts:86

Whether to index scene descriptions and transcripts into the RAG vector store for later retrieval.

Default​

false

maxFrames?​

optional maxFrames: number

Defined in: packages/agentos/src/api/analyzeVideo.ts:52

Maximum number of frames to sample for analysis.

maxScenes?​

optional maxScenes: number

Defined in: packages/agentos/src/api/analyzeVideo.ts:79

Maximum number of scenes to detect. Prevents runaway analysis on very long videos.

Default​

100

model?​

optional model: string

Defined in: packages/agentos/src/api/analyzeVideo.ts:49

Model identifier to use for the vision LLM analysis step.

onProgress()?​

optional onProgress: (event) => void

Defined in: packages/agentos/src/api/analyzeVideo.ts:91

Optional callback invoked as analysis progresses through phases.

Parameters​

event​

VideoAnalysisProgressEvent

Returns​

void

prompt?​

optional prompt: string

Defined in: packages/agentos/src/api/analyzeVideo.ts:46

Text prompt / question to guide the analysis (e.g. "Describe the key actions in this video").

providerOptions?​

optional providerOptions: Record<string, unknown>

Defined in: packages/agentos/src/api/analyzeVideo.ts:94

Arbitrary provider-specific options.

sceneThreshold?​

optional sceneThreshold: number

Defined in: packages/agentos/src/api/analyzeVideo.ts:60

Threshold for scene change detection (0-1). Lower values detect more scene boundaries (more sensitive); higher values only detect dramatic cuts.

Default​

0.3

transcribeAudio?​

optional transcribeAudio: boolean

Defined in: packages/agentos/src/api/analyzeVideo.ts:66

Whether to transcribe the audio track using the configured STT provider.

Default​

true

usageLedger?​

optional usageLedger: AgentOSUsageLedgerOptions

Defined in: packages/agentos/src/api/analyzeVideo.ts:97

Optional durable usage ledger configuration for accounting.

videoBuffer?​

optional videoBuffer: Buffer

Defined in: packages/agentos/src/api/analyzeVideo.ts:40

Raw video bytes. Mutually exclusive with videoUrl.

videoUrl?​

optional videoUrl: string

Defined in: packages/agentos/src/api/analyzeVideo.ts:37

URL of the video to analyse. Mutually exclusive with videoBuffer.