Creates a new job that uses AI to identify key moments in a Mux Video asset. Set use_shots to true to automatically generate or reuse Mux shots and use visual evidence during selection, with transcript evidence incorporated when available; otherwise selection uses transcript evidence and the asset must have a caption track. Audio-only assets always use transcript evidence and require a caption track. Optional output steering can restrict execution to a time scope in seconds and guide selection strategy, title style, audience, topic taxonomy, and scoring priorities without changing the response schema. Scoped results retain absolute timestamps on the original asset timeline.
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 to analyze.
Maximum number of key moments to extract. When omitted, defaults to 10 for assets up to one hour and 25 for longer assets.
Preferred highlight duration range in milliseconds. When provided, the model will aim to select moments within this range.
Preferred minimum highlight duration in milliseconds.
Preferred maximum highlight duration in milliseconds.
Controls whether video assets are analyzed using Mux shots. When true, shots are generated or reused and visual evidence drives selection. When false or omitted, selection uses transcript evidence and the asset must have a caption track. Not supported for audio-only assets.
Curated output_steering controls for execution scope, selection strategy, title style, audience, taxonomy, and rubric tie-breakers. Scope is enforced; other controls guide model behavior but do not guarantee exact output.
Best-effort guidance for what qualifies as a strong standalone key moment.
Best-effort title style guidance for generated moment titles.
Intended audience used as best-effort model guidance. Does not change the output schema.
Preferred brand or domain terms to use when supported by the source content.
Rubric dimensions to use as tie-breakers after applying selection strategy. Best-effort guidance only.
{
"parameters": {
"asset_id": "mux_asset_123abc",
"max_moments": 10,
"target_duration_ms": {
"min": 15000,
"max": 45000
},
"output_steering": {
"scope": {
"start_time": 30,
"end_time": 180
},
"selection_strategy": "educational_takeaways",
"title_style": "punchy",
"audience": "Developer advocates",
"rubric_priorities": [
"clarity_in_isolation",
"soundbite_quality"
]
}
}
}{
"data": {
"id": "rjob_example123",
"workflow": "find-key-moments",
"status": "pending",
"units_consumed": 0,
"created_at": 1700000000,
"updated_at": 1700000060,
"parameters": {
"asset_id": "mux_asset_123abc",
"max_moments": 10,
"target_duration_ms": {
"min": 15000,
"max": 45000
},
"output_steering": {
"scope": {
"start_time": 30,
"end_time": 180
},
"selection_strategy": "educational_takeaways",
"title_style": "punchy",
"audience": "Developer advocates",
"rubric_priorities": [
"clarity_in_isolation",
"soundbite_quality"
]
}
}
}
}