Find Key Moments
Create a 'find-key-moments' job
Creates a new job that uses AI to identify key moments in a Mux Video asset.
post/robots/v0/jobs/find-key-moments
Request body
Example request
{
"parameters": {
"asset_id": "mux_asset_123abc",
"max_moments": 5,
"target_duration_ms": {
"min": 15000,
"max": 45000
}
}
}Response
Key moments job queued
Example response
{
"data": {
"parameters": {
"asset_id": "mux_asset_123abc",
"max_moments": 5,
"target_duration_ms": {
"min": 15000,
"max": 45000
}
},
"outputs": {
"moments": [
{
"start_ms": 15000,
"end_ms": 45000,
"cues": [
{
"start_ms": 15000,
"end_ms": 20000,
"text": "This is the moment everything changed."
},
{
"start_ms": 20000,
"end_ms": 30000,
"text": "We realized the entire approach was wrong."
}
],
"overall_score": 0.92,
"title": "The Pivotal Realization",
"audible_narrative": "The speaker describes the turning point that reshaped the project direction.",
"notable_audible_concepts": [
"pivotal realization moment",
"project direction change"
],
"visual_narrative": "The speaker gestures emphatically at a whiteboard diagram while the camera zooms in.",
"notable_visual_concepts": [
{
"concept": "whiteboard diagram emphasis",
"score": 0.88,
"rationale": "The diagram directly illustrates the pivotal realization being described."
},
{
"concept": "speaker emphatic gestures",
"score": 0.75,
"rationale": "Body language reinforces the emotional weight of the turning point."
}
]
}
]
},
"resources": {
"assets": [
{
"id": "abc123asset",
"meta": {
"title": "My Video",
"creator_id": "user123",
"external_id": "ext456"
},
"_links": {
"self": {
"href": "https://api.mux.com/video/v1/assets/abc123asset"
}
}
}
]
}
}
}