Find Key Moments (v0)

Get a 'find-key-moments' job

Changed on

Deprecated: use GET /robots/v1/jobs/find-key-moments/{job_id} instead. Retrieves the current status and results of a 'find-key-moments' job. Jobs are automatically deleted after 30 days.

get/robots/v0/jobs/find-key-moments/{JOB_ID}

Request

  • Base URL
    https://api.mux.com
  • Auth
    • HTTP basic
    • or HTTP bearer

Path parameters

JOB_IDstring required

Robots job ID returned by job creation or listing (rjob_...).

Response

Current status for the requested job

Example response

{
  "data": {
    "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"
        ]
      }
    },
    "resources": {
      "assets": [
        {
          "id": "abc123asset",
          "meta": {
            "title": "My Video",
            "creator_id": "user123",
            "external_id": "ext456"
          },
          "_links": {
            "self": {
              "href": "/video/v1/assets/abc123asset"
            }
          }
        }
      ]
    },
    "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",
          "quotable_segment": {
            "start_ms": 20000,
            "text": "We realized the entire approach was wrong."
          },
          "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."
            }
          ]
        }
      ]
    }
  }
}

Changes

    • info

      endpoint deprecated

    • info

      api operation id get-find-key-moments-job removed and replaced with get-find-key-moments-job-v0

    • info

      api tag Find Key Moments (v0) added

    • info

      api tag Find Key Moments removed

    • info

      added to the /// response property allOf list for the response status

    • info

      added to the /// response property allOf list for the response status

    • info

      removed from the /// response property allOf list for the response status

    • info

      removed from the /// response property allOf list for the response status