Creates a new job that segments a Mux video asset into ordered scenes using storyboard-backed generated shots for shot-level visual evidence, combined with transcript cues when available. Generated shots must already exist for the asset before a job can be queued. Optional output steering can guide segmentation strategy, title style, narration detail, audience, brand terms, and topic taxonomy without changing the response schema.
Arbitrary string stored with the job and returned in responses. Useful for correlating jobs with your own systems.
The Mux asset ID of the video asset to segment into scenes. Audio-only assets are not supported.
Preferred transcript language code to analyze when a matching transcript track is available. Defaults to the first ready transcript track on the asset.
Optional lower-bound hint for scene segmentation. When provided, the model should avoid collapsing clearly distinct beats below this count when the content supports more granular scene boundaries.
Preferred minimum scene duration in milliseconds for scaffolded transcript chunking. Defaults to 15000.
Curated output_steering controls for segmentation strategy, title style, narration detail, audience, brand terms, and topic taxonomy. These controls guide model behavior but do not guarantee exact output.
Best-effort guidance for the kinds of boundaries the scene finder should prefer.
Best-effort title style guidance for generated scene titles.
Best-effort guidance for how much detail scene narratives should include.
Intended audience used as best-effort model guidance. Does not change the output schema.
Controlled vocabulary used to steer scene concepts without changing the response schema.
Optional customer-facing name for the taxonomy.
Controlled vocabulary values used as best-effort model guidance.
Canonical taxonomy value to prefer when supported by the source content.
Short explanation of when this value applies.
Accepted alternate names that should normalize to the canonical label.
When false, the model should prefer values from the taxonomy. When true, non-taxonomy values may be used when no taxonomy value applies.
{
"parameters": {
"asset_id": "mux_asset_123abc",
"language_code": "en",
"min_scenes": 4,
"min_scene_duration_ms": 15000,
"output_steering": {
"segmentation_strategy": "editorial_beats",
"title_style": "descriptive",
"narration_detail": "balanced"
}
}
}{
"data": {
"id": "rjob_example123",
"workflow": "find-scenes",
"status": "pending",
"units_consumed": 0,
"created_at": 1700000000,
"updated_at": 1700000060,
"parameters": {
"asset_id": "mux_asset_123abc",
"language_code": "en",
"min_scenes": 4,
"min_scene_duration_ms": 15000,
"output_steering": {
"segmentation_strategy": "editorial_beats",
"title_style": "descriptive",
"narration_detail": "balanced"
}
}
}
}