All Products
Search
Document Center

Intelligent Media Management:File

Last Updated:Dec 08, 2025
ParameterTypeDescriptionExample
object

The metadata of the object.

OwnerIdstring

The ID of the Alibaba Cloud account.

102321002467****
ProjectNamestring

The name of the project. You can obtain the name of the project from the response of the CreateProject operation.

test-project
DatasetNamestring

The name of the dataset. You can obtain the name of the dataset from the response of the CreateDataset operation.

test-dataset
ObjectTypestring

The type of the object. Set the value to file.

file
ObjectIdstring

The unique ID of the object.

75d5de2c50754e3dadd5c35dbca5f9949369e37eb342a73821f690c94c36c7f7
UpdateTimestring

The RFC3339Nano timestamp when the metadata was modified.

2021-06-29T14:50:13.011643661+08:00
CreateTimestring

The RFC3339Nano timestamp when the metadata was created.

2021-06-29T14:50:13.011643661+08:00
URIstring

The URI of the file.

The URI of an OSS object 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.

The URI of a file in Photo and Drive Service follows the pds://domains/${domain}/drives/${drive}/files/${file}/revisions/${revision} format.

oss://examplebucket/sampleobject.jpg
OSSURIstring

The URI of the OSS object. This parameter is available only if the value of the URI parameter is the URI of a file in Photo and Drive Service.

oss://examplebucket/sampleobject.jpg
Filenamestring

The name of the object. For an OSS object, the value of this parameter is the object name.

sampleobject.jpg
MediaTypestring

The media type of the file.

Valid values:

  • image
  • other
  • document
  • archive
  • audio
  • video
image
ContentTypestring

The Multipurpose Internet Mail Extensions (MIME) type of the file.

image/jpeg
Sizelong

The size of the object. Unit: bytes.

1000
FileHashstring

The hash value of the file.

1d9c280a7c4f67f7ef873e28449dbe17
FileModifiedTimestring

The RFC3339Nano timestamp when the file was last modified.

2021-06-29T14:50:13.011643661+08:00
FileCreateTimestring

The RFC3339Nano timestamp when the file was created.

2021-06-29T14:50:13.011643661+08:00
FileAccessTimestring

The RFC3339Nano timestamp when the file was accessed.

2021-06-29T14:50:13.011643661+08:00
ProduceTimestring

The time when the image was taken.

2021-06-29T14:50:13.011643661+08:00
LatLongstring

The latitude and longitude.

30.134390,120.074997
Timezonestring

The time zone.

Note Not supported.
""
Addressesarray

The addresses.

Address

The address.

TravelClusterIdstring

A reserved parameter.

Note Not supported.
-
Orientationlong

The image rotation angle. You can obtain the value from the exchangeable image file format (EXIF).

If the EXIF metadata does not contain the image rotation angle, this parameter is not included in the response.

0
Figuresarray

The list of persons. The persons are detected via AI models.

FiguresFigure

The persons.

FigureCountlong

The number of persons.

10
Labelsarray

The labels of the file. The labels are detected via AI models.

LabelsLabel

The label of the file.

Titlestring

The title of the file.

test
ImageWidthlong

The width of the image. Unit: pixels.

270
ImageHeightlong

The height of the image. Unit: pixels.

500
EXIFstring

The original EXIF information about the image. The EXIF information is stored in the serialized JSON format. For more information, see Query image information.

{"Compression":{"value":"6"},"DateTime":{"value":"2020:08:19 17:11:11"}}
ImageScoreImageScore

The score of the image. The score is calculated by using AI models.

CroppingSuggestionsarray

The cropping suggestions for the image.

Note Not supported.
CroppingSuggestionsCroppingSuggestion

The cropping suggestion for the image.

OCRContentsarray

The Optical Character Recognition (OCR) results.

Note Not supported.
OCRContents

The OCR result.

VideoWidthlong

The width of the video. Unit: pixels.

1080
VideoHeightlong

The height of the video. Unit: pixels.

1920
VideoStreamsarray

The list of video streams.

VideoStreamsVideoStream

The video stream.

Subtitlesarray

The list of subtitle streams.

SubtitlesSubtitleStream

The subtitle stream.

AudioStreamsarray

The list of audio streams.

AudioStreamsAudioStream

The audio stream.

Artiststring

The artist.

Jane
AlbumArtiststring

The singer.

Jane
AudioCoversarray

The audio covers.

AudioCoversImage

The audio cover.

Composerstring

The composer.

Jane
Performerstring

The performer.

Jane
Languagestring

The language specified by using a BCP 47 language tag.

eng
Albumstring

The album.

FirstAlbum
PageCountlong

The number of pages.

Note Not supported.
5
ETagstring

The ETag of the object. ETags are used to identify the content of objects.

"1D9C280A7C4F67F7EF873E28449****"
CacheControlstring

The caching behavior of the web page when the object is downloaded.

This parameter corresponds to the Cache-Control HTTP header of the OSS object. For more information, see Manage object metadata.

no-cache
ContentDispositionstring

The name of the object during the download.

This parameter corresponds to the Content-Disposition HTTP header of the OSS object. For more information, see Manage object metadata.

attachment; filename =test.jpg
ContentEncodingstring

The content encoding format of the object when the object is downloaded.

This parameter corresponds to the Content-Encoding HTTP header of the OSS object. For more information, see Manage object metadata.

UTF-8
ContentLanguagestring

The language of the object content.

This parameter corresponds to the Content-Language HTTP header of the OSS object. For more information, see Manage object metadata.

zh-CN
AccessControlAllowOriginstring

The origin allowed in cross-origin requests.

https://aliyundoc.com
AccessControlRequestMethodstring

The method to be used in the actual cross-origin request.

PUT
ServerSideEncryptionCustomerAlgorithmstring

The algorithm that is used to encrypt the file on the server side.

SM4
ServerSideEncryptionstring

The encryption method on the server side.

This parameter is available only if server encryption is configured for the OSS bucket. For more information, see Server-side encryption.

AES256
ServerSideDataEncryptionstring

The encryption method of the object.

This parameter is available only if server encryption is configured for the OSS bucket. For more information, see Server-side encryption.

SM4
ServerSideEncryptionKeyIdstring

The ID of the customer master key (CMK) managed by Key Management Service (KMS).

This parameter is available only if server encryption is configured for the OSS bucket. For more information, see Server-side encryption.

9468da86-3509-4f8d-a61e-6eab1eac****
OSSStorageClassstring

The storage class of the OSS bucket.

Standard
OSSCRC64string

The CRC64 value.

559890638950338001
ObjectACLstring

The access control list (ACL) of the OSS object.

default
ContentMd5string

The MD5 value.

HZwoCnxPZ/fvhz4oRJ2+Fw==
OSSUserMetaobject

The user metadata of the OSS object.

This parameter is available only if user metadata is configured for the OSS object. For more information, see Manage object metadata.

{"key": "val"}
OSSTaggingCountlong

The number of OSS object tags.

This parameter is available only if tags are added to the corresponding OSS object. For more information, see Add tags to an object.

2
OSSTaggingobject

The tag of the object.

For more information, see Add tags to an object.

{"key": "val"}
OSSExpirationstring

The expiration time of the OSS object.

This parameter corresponds to the Expires HTTP header of the OSS object. For more information, see Manage object metadata.

2120-01-01T12:00:00.000Z
OSSVersionIdstring

The version of the object.

This parameter is available only if versioning is enabled for the bucket. For more information, see Overview .

CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0****
OSSDeleteMarkerstring

The delete marker of the object.

CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****
OSSObjectTypestring

The type of the OSS object. Set the value to Normal.

Normal
CustomIdstring

The custom ID of the file. When the cluster is indexed into the dataset, the custom ID is stored as the data attribute. You can map the custom ID to other data in your business system. Configure this parameter based on your business requirements. For example, you can associate a URI with an ID in your system. We recommend that you set this parameter to a globally unique value.

member-image-id-0001
CustomLabelsobject

The custom labels of the file. This parameter is optional. The parameter stores custom key-value labels, which can be used to filter data.

{ "MemberName": "Tim", "Enabled": "True", "ItemCount": "10" }
StreamCountlong

The number of media streams in the media container.

1
ProgramCountlong

The number of programs in the media container.

1
FormatNamestring

The name of the media format.

mov
FormatLongNamestring

The full name of the media format.

QuickTime / MOV
StartTimedouble

The time of the first frame. Unit: seconds.

0.000000
Bitratelong

The bitrate. Unit: bit/s.

13091201
Durationdouble

The total duration of the video. Unit: seconds.

15.263000
SemanticTypesarray

The reasons for which the current file is included in the search results when you call the SemanticQuery operation for semantic search.

string

The reason for which the current file is included in the search results when you call the SemanticQuery operation for semantic search.

Valid values:

  • content: The semantic content of the document or the content of the image matches the query criteria.

  • text: The text of the document or image matches the query criteria.

  • datetime: The creation time of the file matches the query criteria.

  • address: The authoring location of the file matches the query criteria.

  • figure: The character names contained in the file match the query criteria.

    **

    Note The number of the valid values may increase as the algorithm evolves.

content
Elementsarray

The document elements that match the current query content when you call the SemanticQuery operation for semantic search.

Element

The document element that matches the current query content.

SceneElementsarray

The elements in the video segment, which are scene elements that you can extract from the video by using an AI model.

SceneElement

The element in the video segment.

OCRTextsstring

The text detected in the image.

Alibaba Cloud IMM
Reasonstring

The reason why the file failed to run the index.

[InternalError] The request has been failed due to some unknown error. status: 500, requestId: CC5ACFBD-BB7A-496D-A9D6-****
ObjectStatusstring

The status of the object.

Enumeration Value:
  • Failed: 文件执行索引构建失败。.
  • Indexed: 文件执行索引构建完成。.
  • Pending: 文件已经提交索引任务,准备进入索引构建。.
  • Deleting: 文件处于删除中,此时该文件进入清理阶段,此阶段用户无法对文件进行写操作,如IndexFileMeta、UpdateFileMeta会返回409.
  • Indexing: 文件执行索引构建任务过程中。.
Indexed
InsightsInsights

Summary and description of the file.

Note Not supported.