Find Best Thumbnails (v0)

Get a 'find-best-thumbnails' job

Changed on

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

get/robots/v0/jobs/find-best-thumbnails/{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

Find best thumbnails job state

Example response

{
  "data": {
    "id": "rjob_example",
    "workflow": "find-best-thumbnails",
    "status": "completed",
    "units_consumed": 100,
    "created_at": 1791302400,
    "updated_at": 1791302460,
    "parameters": {
      "asset_id": "mux_asset_123abc",
      "max_thumbnails": 1
    },
    "outputs": {
      "best_thumbnails": [
        {
          "timestamp_ms": 23000,
          "subscores": {
            "focus": 0.9,
            "face_or_action": 0.8,
            "composition": 0.9,
            "contrast_color": 0.8,
            "brand_fit": 0.7
          },
          "overall": 0.82,
          "description": "A presenter demonstrating the product against a clear background.",
          "alt_text": "Presenter holding the product toward the camera."
        }
      ]
    }
  }
}

Changes

    • info

      endpoint deprecated

    • info

      api operation id get-find-best-thumbnails-job removed and replaced with get-find-best-thumbnails-job-v0

    • info

      api tag Find Best Thumbnails (v0) added

    • info

      api tag Find Best Thumbnails removed

    • info

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

    • info

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