{
  "opencollection": "1.0.0",
  "info": {
    "name": "Mux Animated Images Thumbnails API",
    "version": "v1"
  },
  "items": [
    {
      "info": {
        "name": "Thumbnails",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Retrieve a Video Thumbnail",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mux.com/:PLAYBACK_ID/thumbnail.:EXTENSION",
            "params": [
              {
                "name": "PLAYBACK_ID",
                "value": "",
                "type": "path",
                "description": "The asset or live stream's playback ID."
              },
              {
                "name": "TOKEN",
                "value": "",
                "type": "query",
                "description": "Signed token (JWT) for [secure video playback](https://docs.mux.com/guides/secure-video-playback)."
              },
              {
                "name": "EXTENSION",
                "value": "",
                "type": "path",
                "description": "The image file extension, either 'jpg', 'png', or 'webp'."
              },
              {
                "name": "time",
                "value": "",
                "type": "query",
                "description": "The time (in seconds) of the video timeline where the image should be pulled. Defaults to the middle of the original video."
              },
              {
                "name": "width",
                "value": "",
                "type": "query",
                "description": "The width of the thumbnail (in pixels). Defaults to the width of the original video."
              },
              {
                "name": "height",
                "value": "",
                "type": "query",
                "description": "The height of the thumbnail (in pixels). Defaults to the height of the original video."
              },
              {
                "name": "rotate",
                "value": "",
                "type": "query",
                "description": "Rotate the image clockwise by the given number of degrees."
              },
              {
                "name": "fit_mode",
                "value": "",
                "type": "query",
                "description": "How to fit a thumbnail within the specified width + height."
              },
              {
                "name": "flip_v",
                "value": "",
                "type": "query",
                "description": "Flip the image top-bottom after performing all other transformations."
              },
              {
                "name": "flip_h",
                "value": "",
                "type": "query",
                "description": "Flip the image left-right after performing all other transformations."
              },
              {
                "name": "program_time",
                "value": "",
                "type": "query",
                "description": "Set the time of the thumbnail for an asset created from a live stream when using the [instant clipping feature](https://docs.mux.com/guides/create-instant-clips). The timestamp should be provided as an epoch integer, and is compared to the program date time (PDT) generated by a live stream."
              },
              {
                "name": "latest",
                "value": "",
                "type": "query",
                "description": "When set to `true`, pulls the latest thumbnail from the playback ID of an ongoing live stream. Can only be used with live streams. Can be used to build moderation and classification workflows, [see documentation for more details](https://mux.com/docs/guides/get-images-from-a-video#getting-the-latest-thumbnail-from-a-live-stream)."
              }
            ]
          },
          "docs": "[Fetch a thumbnail image from a video](https://docs.mux.com/guides/get-images-from-a-video) at a specified time with optional transformations."
        }
      ]
    }
  ],
  "bundled": true
}