Create a new extract job

Input media URL. Supports URIs of files uploaded to Cloudglue Files endpoint, public YouTube video URLs, public TikTok video URLs, public Loom share URLs, public HTTP URLs (including direct image URLs such as JPEG/PNG/WebP), and files which have been granted access to Cloudglue via data connectors.

Note that YouTube videos are currently limited to speech level understanding only. Public TikTok video URLs will be scraped and stored automatically — subject to charges. For files via our Data connectors, see our documentation on data connectors for setup information.

A natural language prompt describing the data you want to extract. Required if no schema is provided.

Whether to extract entities at the video level. Mutually exclusive with enable_segment_level_entities - only one can be true.

Whether to extract entities at the segment level. Mutually exclusive with enable_video_level_entities - only one can be true.

When enabled, extract entities from transcript only (similar to YouTube path). Useful for speech-heavy content.

When enabled, extract entities from the file's metadata document (filename, file details, user metadata, and connector source metadata) instead of the media content. File-level entities only; flat 1 credit per file; works on metadata-only files without ingesting their media. Mutually exclusive with enable_transcript_mode.

Include narrative chapters in the response when segmentation strategy is 'narrative'. Only affects cached completed results; newly created pending jobs do not include chapters.

Include shot boundaries in the response when segmentation strategy is 'shot-detector'. Only affects cached completed results; newly created pending jobs do not include shots.

Segmentation job id to use. If not provided will use default to uniform 20s segmentation. Cannot be provided together with segmentation_config.

The URL of the processed video

Unix timestamp in milliseconds when the job was created

The ID of the segmentation job used for this extraction

Total number of segment entities available. Only present when status is 'completed'.

Maximum number of segment entities returned per request. Only present when status is 'completed'.

Number of segment entities skipped. Only present when status is 'completed'.

Error message if status is 'failed'

Total number of chapters (only present when include_chapters=true and segmentation strategy is 'narrative')

Total number of shots (only present when include_shots=true and segmentation strategy is 'shot-detector')