Convert video to animated image

Prerequisites

• An AccessKey pair is created and obtained. For more information, see Create an AccessKey pair.

• Object Storage Service (OSS) is activated and a bucket is created. For more information, see Create a bucket.

• IMM is activated. For more information, see Activate IMM.

• A project is created in the IMM console. For more information, see Create a project.

  Note

  • You can call the CreateProject operation to create a project. For more information, see CreateProject.

  • You can call the ListProjects operation to list information of all projects in a region.

Step 1: Upload a file

Use the OSS console to upload your media file to a bucket in the same region as your IMM project.

On the upload page, keep File ACL set to the default value Inherit Bucket, click Scan Files, and select the media file to upload.

Step 2: Use IMM to convert video to animated image

Call the Create Media Transcoding Job API to create a video-to-animated-image conversion job.

Generate an animated thumbnail from the entire video

Transcoding settings

• Animated image format: WebP

• Frame sampling interval: 1 second

• Animated image frame rate: 15

• Animated image resolution: half the source video resolution

• Scaling method: scale without preserving black bars. For more information about scaling methods, see Scaling methods.

• Output file path: oss://test-bucket/video-demo/animation.webp

• Transcoding completion notification: send an MNS message to the MNS topic “test-mns-topic”

For an SDK example, see OpenAPI Explorer. The example parameters are pre-filled. Modify them as needed before testing.

Request parameters

{
  "ProjectName": "test-project",
  "Notification": {
    "MNS": {
      "TopicName": "test-mns-topic"
    }
  },
  "Sources": [
    {
      "URI": "oss://test-bucket/video-demo/brewing.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Animations": [
          {
            "Format": "webp",
            "FrameRate": 15,
            "Height": 0.5,
            "Interval": 1,
            "ScaleType": "fit",
            "URI": "oss://test-bucket/video-demo/animation.{autoext}",
            "Width": 0.5
          }
        ]
      }
    }
  ]
}

Generate an animated thumbnail from seconds 5 to 30 of the video

Transcoding settings

• Animated image format: WebP

• Frame sampling start time: second 5

• Frame sampling duration: 25 seconds

• Frame sampling interval: 1 second

• Animated image frame rate: 15

• Animated image resolution: half the source video resolution

• Scaling method: scale without preserving black bars. For more information about scaling methods, see Scaling methods.

• Output file path: oss://test-bucket/video-demo/animation.webp

• Transcoding completion notification: send an MNS message to the MNS topic “test-mns-topic”

For an SDK example, see OpenAPI Explorer. The example parameters are pre-filled. Modify them as needed before testing.

Request parameters

{
  "ProjectName": "test-project",
  "Notification": {
    "MNS": {
      "TopicName": "test-mns-topic"
    }
  },
  "Sources": [
    {
      "Duration": 25,
      "StartTime": 5,
      "URI": "oss://test-bucket/video-demo/brewing.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Animations": [
          {
            "Format": "webp",
            "FrameRate": 15,
            "Height": 0.5,
            "Interval": 1,
            "ScaleType": "fit",
            "URI": "oss://test-bucket/video-demo/animation.{autoext}",
            "Width": 0.5
          }
        ]
      }
    }
  ]
}