All Products
Search
Document Center

Intelligent Media Management:TargetImage

Last Updated:Oct 09, 2025
ParameterTypeDescriptionExample
object

The information about the frames captured, sprites, or animated images.

Spritesarray<object>

The sprites.

object

The information about the sprite.

ScaleTypestring

The resizing mode. Valid values:

  • stretch: stretches the image to fill the entire space. This is the default value.
  • crop: resizes and crops the image.
  • fill: resizes the image and keeps the black border.
  • fit: resizes the image and removes the black border.
crop
StartTimedouble

The time in seconds at which frame capturing starts. The default value is 0, which indicates that frame capturing starts at the beginning of the video.

0
TileHeightinteger

The number of small images in each column. Default value: 6.

6
URIstring

The URI of the sprite in Object Storage Service (OSS).

The OSS URI follows the oss://bucket/object format, where bucket is the name of the bucket in the same region as the current project and object is the path of the object with the extension included.

oss://test-bucket/sprites
ScaleWidthfloat

The width of individual small images. The default value is 1. The value can be an integer or a decimal.

  • An integer: the number of pixels. Valid values: (1,4096).
  • A decimal: the ratio relative to the width of the target video resolution. Valid values: (0,1].
1280
Padinteger

The padding between small images. Default value: 2.

2
Formatstring

The format of the sprite. Valid values:

  • jpg
  • png
jpg
Numberinteger

The number of small images in the sprite. The default value is 0, which indicates that frames are captured until the end of the video.

0
ScaleHeightfloat

The height of individual small images. The default value is 1. The value can be an integer or a decimal.

  • An integer: the number of pixels. Valid values: (1,4096).
  • A decimal: the ratio relative to the height of the target video resolution. Valid values: (0,1].
960
TileWidthinteger

The number of small images in each row. Default value: 6.

6
Intervaldouble

The time interval of frame capturing in seconds.

1
Margininteger

The margin between the small images and the edges of the sprite. Default value: 2.

2
Animationsarray<object>

The animated images.

object

The information about the animated image.

FrameRatedouble

The frame rate of the animated image. You can use this parameter together with the Interval parameter to slow down the animation.

25
Formatstring

The format of the animated image. Valid values:

  • gif
  • webp
gif
Numberinteger

The number of extracted frames. The default value is 0, which indicates that frames are extracted until the end of the video.

100
ScaleTypestring

The resizing mode. Valid values:

  • stretch: stretches the image to fill the entire space. This is the default value.
  • crop: resizes and crops the image.
  • fill: resizes the image and keeps the black border.
  • fit: resizes the image and removes the black border.
crop
StartTimedouble

The start time for extracting frames. Unit: seconds. Default value: 0.

0
Heightdouble

The height of the animated image. By default, the animated image has the same height as the source video. The value of the parameter can be an integer or a decimal.

  • An integer: the number of pixels. Valid values: [1,4096].
  • A decimal: the ratio relative to the height of the target image resolution. Valid values: (0,1).
960
URIstring

The URI of the animated image.

The OSS URI follows the oss://bucket/object format, where bucket is the name of the bucket in the same region as the current project and object is the path of the object with the extension included.

oss://test-bucket/animations
Widthdouble

The width of the animated image. By default, the animated image has the same width as the source video. The value of the parameter can be an integer or a decimal.

  • An integer: the number of pixels. Valid values: [1,4096].
  • A decimal: the ratio relative to the width of the target image resolution. Valid values: (0,1).
1280
Intervaldouble

The time interval for extracting frames. Unit: seconds.

0.5
Snapshotsarray<object>

The frames.

object

The information about the frame.

Formatstring

The format of the frame. Valid values:

  • jpg
  • png
jpg
Numberinteger

The number of frames. The default value is 0, which indicates that frames are captured until the end of the video.

10
ScaleTypestring

The resizing mode. Valid values:

  • stretch: stretches the image to fill the entire space. This is the default value.
  • crop: resizes and crops the image.
  • fill: resizes the image and keeps the black border.
  • fit: resizes the image and removes the black border.
crop
StartTimedouble

The time in seconds at which frame capturing starts. The default value is 0, which indicates that frame capturing starts at the beginning of the video.

0
Heightdouble

The height of the frame image. By default, the image has the same height as the source video. The value of the parameter can be an integer or a decimal.

  • An integer: the number of pixels. Valid values: [1,4096].
  • A decimal: the ratio relative to the height of the target image resolution. Valid values: (0,1).
960
URIstring

The OSS URI of the frame.

The OSS URI follows the oss://bucket/object format, where bucket is the name of the bucket in the same region as the current project and object is the path of the object with the extension included.

oss://test-bucket/snapshots
Widthdouble

The width of the frame image. By default, the image has the same width as the source video. The value of the parameter can be an integer or a decimal.

  • An integer: the number of pixels. Valid values: [1,4096].
  • A decimal: the ratio relative to the width of the target image resolution. Valid values: (0,1).
1280
Intervaldouble

The time interval of frame capturing in seconds.

0.5