CLcloudglue
Find Moments

Find moments in a video

Changed on

Runs exhaustive moment discovery for one criterion over one video. Every accepted moment is persisted; ranking and truncation are read-time parameters on GET. Reuses a compatible describe or creates one internally - a missing describe is never an error.

post/find-moments

Request

  • Base URL
    https://api.cloudglue.dev/v1
  • Auth
    HTTP bearer

Request body

urlstring required

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

describe_job_idstring uuid

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

signals_requiredstring[]
boundary_policy'sentence' | 'tight' | 'loose'
min_duration_secondsnumber
max_duration_secondsnumber
cache_policy'reuse' | 'refresh'

Response

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

job_idstring uuid required
status'pending' | 'processing' | 'completed' | 'failed' | 'cancelled' required
created_atinteger required

Unix timestamp in milliseconds when the run was created

urlstring required
total_momentsinteger

Full accepted count, independent of the limit read parameter.

errorstring

Curated failure message, present on failed runs.

Changes

  • 23d3f240819fRevision changes
    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • d2a5205fc779Revision changes
    • info

      endpoint added