Skip to main content
POST
Find moments in a video

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Find-moments run parameters

url
string
required

cloudglue://files/ or an ingestible URL (same resolution rules as describe/extract).

criterion
object
required

An inline criterion: rubric instructions plus typed output declarations. Snapshotted and hashed onto the run.

describe_job_id
string<uuid>

Optional pin to a specific describe. It must exist for the file and its config must cover signals_required.

signals_required
enum<string>[]
Minimum array length: 1
Available options:
speech,
visual_scene_description,
scene_text,
audio_description
boundary_policy
enum<string>
default:sentence
Available options:
sentence,
tight,
loose
speaker_filter
object
min_duration_seconds
number
default:5
Required range: x > 0
max_duration_seconds
number
default:300
Required range: x > 0
cache_policy
enum<string>
default:reuse
Available options:
reuse,
refresh

Response

The created run, or an existing matching run at cost 0 (cache hit).

job_id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
processing,
completed,
failed
created_at
integer
required

Unix timestamp in milliseconds when the run was created

url
string
required
find_moments_config
object

Echo of the request plus criterion_hash and the resolved describe_job_id.

moments
object[]
findings
object[]
total_moments
integer

Full accepted count, independent of the limit read parameter.

error
string

Curated failure message, present on failed runs.