BAbannerbear

Find moments

Changed on

Find quotable short moments in a long video recording. Async — returns 202 with a pending job; poll GET /tool_jobs/{uid} until status is completed or failed.

post/tools/find_moments

Request

  • Base URL
    https://api.bannerbear.com/v5
  • Auth
    HTTP bearer

Request body

video_urlstring uri required

A recording with speech, up to 1 GB

countinteger

How many moments to return, best first, up to 10

min_secondsnumber

No moment is shorter than this

max_secondsnumber

No moment is longer than this

language'' | 'en' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'nl' | 'ru' | 'pl' | 'tr' | 'ar' | 'hi' | 'zh' | 'ja' | 'ko' | 'id' | 'vi' | 'th'

Auto detect works well when the audio is clear

guidancestring

What to look for, such as advice for founders or funny stories

metadatastring

Arbitrary metadata string stored with the tool run

Response

Tool run accepted

uidstring
tool'find_moments'
status'pending' | 'running' | 'completed' | 'failed'

pending → running → completed / failed

progressinteger

0-100 job progress, 100 once completed

inputsobject

Inputs the job was created with

metadatastring nullable

Arbitrary metadata string round-tripped from the create request

selfstring uri
created_atstring date-time
completed_atstring date-time nullable
error_messagestring nullable

Human-readable failure reason (only present on failed jobs)

Changes