MUmuxinc
Find Best Thumbnails

Create a 'find-best-thumbnails' job

Changed on

Creates a new job that samples thumbnails from a Mux Video asset, scores them with AI, and selects the best thumbnail candidates. Optional output_steering.scope hard-limits sampling to a time window expressed in seconds while returned timestamps stay absolute to the asset timeline. Other output steering can guide scoring strategy, explicit user intent, audience, and campaign style without changing the response schema.

post/robots/v1/jobs/find-best-thumbnails

Request

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

Request body

passthroughstring

Arbitrary string stored with the job and returned in responses. Useful for correlating jobs with your own systems.

Example request

{
  "parameters": {
    "asset_id": "mux_asset_123abc",
    "max_thumbnails": 5
  }
}

Response

Find best thumbnails job queued

Example response

{
  "data": {
    "id": "rjob_example",
    "workflow": "find-best-thumbnails",
    "parameters": {
      "asset_id": "mux_asset_123abc",
      "max_thumbnails": 5
    },
    "status": "completed",
    "units_consumed": 1,
    "created_at": 1750000000,
    "updated_at": 1750000010,
    "outputs": {
      "best_thumbnails": [
        {
          "time": 23.456,
          "overall": 0.82,
          "subscores": {
            "focus": 0.9,
            "face_or_action": 0.8,
            "composition": 0.9,
            "contrast_color": 0.8,
            "brand_fit": 0.7
          },
          "description": "A presenter demonstrating the product.",
          "alt_text": "Presenter holding the product."
        }
      ]
    }
  }
}

Changes