File

名称

类型

是否必选

示例值

描述

URI

字符串

否

oss://examplebucket/photos/sunset.jpg

OSS Object 的完整 URI。

父节点:File

OSSURI

字符串

否

oss://examplebucket/photos/sunset.jpg

URI 的别名,部分场景使用此字段名。

父节点:File

Filename

字符串

否

photos/sunset.jpg

文件名(OSS Object 的 Key)。

父节点:File

Size

整型

否

2097152

文件大小,单位为字节。

父节点:File

ContentType

字符串

否

image/jpeg

文件的 MIME 类型。

父节点:File

ETag

字符串

否

"D41D8CD98F00B204E9800998ECF8427E"

OSS Object 的 ETag。

父节点:File

ContentMd5

字符串

否

1B2M2Y8AsgTpgAmY7PhCfg==

文件的 Content-MD5。

父节点:File

OSSCRC64

字符串

否

12345678901234567890

文件的 CRC64 校验和。

父节点:File

FileHash

字符串

否

abc123def456

文件内容的哈希值。

父节点:File

ContentEncoding

字符串

否

gzip

Object 上传时设置的 Content-Encoding。

父节点:File

ContentLanguage

字符串

否

zh-CN

Object 上传时设置的 Content-Language。

父节点:File

ContentDisposition

字符串

否

attachment; filename="sunset.jpg"

Object 上传时设置的 Content-Disposition。

父节点:File

CacheControl

字符串

否

max-age=3600

Object 上传时设置的 Cache-Control。

父节点:File

MediaType

字符串

否

image

媒体类型。取值如下:

• image：图片

• video：视频

• audio：音频

• document：文档

父节点:File

OSSStorageClass

字符串

否

Standard

OSS 存储类型。取值如下:

• Standard：标准存储

• IA：低频访问存储

• Archive：归档存储

• ColdArchive：冷归档存储

• DeepColdArchive：深度冷归档存储

父节点:File

ObjectACL

字符串

否

default

OSS Object 的访问权限。取值如下:

• default：继承 Bucket 权限

• private：私有

• public-read：公共读

• public-read-write：公共读写

父节点:File

OSSObjectType

字符串

否

Normal

OSS Object 类型。取值如下:

• Normal：普通 Object

• Multipart：分片上传

• Appendable：可追加

父节点:File

OSSVersionId

字符串

否

CAEQNRiBgIDyz.6C0BYiIGQ2Y2I0ZTQ1Mz****

OSS Object 的版本 ID。

父节点:File

OSSDeleteMarker

字符串

否

true

当前版本是否为删除标记。

父节点:File

OSSExpiration

字符串

否

2026-12-31T00:00:00.000Z

OSS 生命周期规则给出的过期时间,RFC 3339 格式。

父节点:File

OSSTagging

容器

否

不涉及

OSS Object Tag 列表容器。每条 Tag 对应一个 <Tagging> 子元素,内含 <Key> 与 <Value> 两个字段。完整样例见下方 OSSTagging / OSSUserMeta XML 样例。

父节点:File

OSSTaggingCount

整型

否

2

OSS Object Tag 的数量。

父节点:File

OSSUserMeta

容器

否

不涉及

OSS 用户自定义 metadata 容器,对应上传时的 x-oss-meta-* 头。每条 metadata 对应一个 <UserMeta> 子元素,内含 <Key> 与 <Value> 两个字段。完整样例见下方 OSSTagging / OSSUserMeta XML 样例。

父节点:File

ServerSideEncryption

字符串

否

AES256

服务端加密算法。

父节点:File

ServerSideEncryptionCustomerAlgorithm

字符串

否

AES256

用户提供密钥时使用的加密算法。

父节点:File

ServerSideEncryptionKeyId

字符串

否

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

KMS 密钥 ID。

父节点:File

ServerSideDataEncryption

字符串

否

SM4

KMS 数据加密算法。

父节点:File

AccessControlAllowOrigin

字符串

否

*

CORS 响应头 Access-Control-Allow-Origin。

父节点:File

AccessControlRequestMethod

字符串

否

GET

CORS 请求头 Access-Control-Request-Method。

父节点:File

CreateTime

字符串

否

2026-05-20T08:00:00.000+08:00

元数据首次建立时间,RFC 3339 格式。

父节点:File

UpdateTime

字符串

否

2026-05-20T08:30:00.000+08:00

元数据上次更新时间,RFC 3339 格式。

父节点:File

FileCreateTime

字符串

否

2026-05-18T10:00:00.000+08:00

文件创建时间,RFC 3339 格式。

父节点:File

FileModifiedTime

字符串

否

2026-05-19T15:30:00.000+08:00

文件最近修改时间,RFC 3339 格式。

父节点:File

FileAccessTime

字符串

否

2026-05-19T15:30:00.000+08:00

文件最近访问时间,RFC 3339 格式。

父节点:File

ProduceTime

字符串

否

2026-04-01T12:00:00.000+08:00

拍摄或制作时间,从 EXIF 或多媒体元数据中解析,RFC 3339 格式。

父节点:File

Timezone

字符串

否

UTC+08:00

时区信息。

父节点:File

LatLong

字符串

否

30.2741,120.1551

地理坐标,格式为 纬度,经度。

父节点:File

Addresses

容器

否

不涉及

地址解析结果列表。每个子元素为一条地址记录,含国家、省、市、区等字段。

父节点:File

DatasetName

字符串

否

photos-2026

文件所在的 Dataset 名。

父节点:File

Language

字符串

否

zh

文件语言。

父节点:File

CustomId

字符串

否

user-12345

用户自定义标识。

父节点:File

CustomLabels

容器

否

不涉及

用户自定义标签容器。

父节点:File

Reason

字符串

否

不涉及

文件处理失败或异常时的原因描述。

父节点:File

名称

类型

是否必选

示例值

描述

ImageWidth

整型

否

4032

图片宽度,单位为像素。

父节点:File

ImageHeight

整型

否

3024

图片高度,单位为像素。

父节点:File

Orientation

整型

否

1

EXIF 方向。

父节点:File

EXIF

字符串

否

{"Make":"Canon",...}

EXIF 完整信息,JSON 字符串。

父节点:File

ImageScore

容器

否

不涉及

图片质量评分。子元素含 <OverallScore> 等。

父节点:File

CroppingSuggestions

容器

否

不涉及

智能裁剪建议列表。

父节点:File

OCRContents

容器

否

不涉及

OCR 文本识别结果,分块形式。

父节点:File

OCRTexts

字符串

否

OCR 合并后的文本内容

OCR 文本识别结果,合并为单条字符串。

父节点:File

名称

类型

是否必选

示例值

描述

VideoWidth

整型

否

1920

视频帧宽度,单位为像素。

父节点:File

VideoHeight

整型

否

1080

视频帧高度,单位为像素。

父节点:File

Duration

浮点型

否

120.5

时长,单位为秒。

父节点:File

Bitrate

整型

否

8000000

码率,单位为 bps。

父节点:File

FormatName

字符串

否

mov,mp4,m4a,3gp,3g2,mj2

容器格式短名称。

父节点:File

FormatLongName

字符串

否

QuickTime / MOV

容器格式完整名称。

父节点:File

StreamCount

整型

否

2

多媒体流的数量。

父节点:File

ProgramCount

整型

否

1

节目数量。

父节点:File

StartTime

浮点型

否

0.0

起始时间,单位为秒。

父节点:File

VideoStreams

容器

否

不涉及

视频轨道详情列表。每个子元素含编码、分辨率、帧率、码率等。

父节点:File

AudioStreams

容器

否

不涉及

音频轨道详情列表。每个子元素含编码、采样率、声道数等。

父节点:File

AudioCovers

容器

否

不涉及

音频封面图列表。

父节点:File

Subtitles

容器

否

不涉及

字幕轨道列表。

父节点:File

名称

类型

是否必选

示例值

描述

Title

字符串

否

Imagine

标题。

父节点:File

Album

字符串

否

Imagine

专辑名称。

父节点:File

AlbumArtist

字符串

否

John Lennon

专辑艺术家。

父节点:File

Artist

字符串

否

John Lennon

艺术家。

父节点:File

Composer

字符串

否

John Lennon

作曲。

父节点:File

Performer

字符串

否

John Lennon

表演者。

父节点:File

名称

类型

是否必选

示例值

描述

PageCount

整型

否

12

文档总页数。

父节点:File

名称

类型

是否必选

示例值

描述

Insights

容器

否

不涉及

AI 内容理解结果容器,含按媒体类型组织的 caption、summary、description 等。详细字段见下方 Insights 子结构。

父节点:File

Labels

容器

否

不涉及

AI 标签列表容器。子节点:Label。详细字段见下方 Labels 子结构。

父节点:File

SemanticTypes

字符串列表

否

不涉及

语义类型列表。子节点:SemanticType。

父节点:File

SceneElements

容器

否

不涉及

场景元素列表,主要用于视频。子元素含 <FrameTimes>、<TimeRange>、<VideoStreamIndex>、<Labels> 等。

父节点:File

Elements

容器

否

不涉及

通用元素列表。

父节点:File

名称

类型

是否必选

示例值

描述

Image

容器

否

不涉及

图片内容理解结果容器。

父节点:Insights

Video

容器

否

不涉及

视频内容理解结果容器。

父节点:Insights

Caption

字符串

否

一只橘猫趴在客厅沙发上,阳光从窗外洒入。

简短描述。

父节点:Insights.Image 或 Insights.Video

Description

字符串

否

画面中有一只橘色的猫,体型偏胖,趴卧在浅灰色的布艺沙发上,身体微微蜷缩。

详细描述。

父节点:Insights.Image 或 Insights.Video

Summary

字符串

否

视频展示了一只橘猫从入睡到苏醒的全过程。

视频概要。

父节点:Insights.Video

名称

类型

是否必选

示例值

描述

Label

容器

否

不涉及

单个标签的容器。

父节点:Labels

子节点:LabelName、LabelConfidence、LabelLevel、ParentLabelName、LabelAlias、Language、CentricScore、Clips

LabelName

字符串

否

猫

标签名称。

父节点:Label

LabelConfidence

浮点型

否

0.98

置信度,取值范围 [0, 1]。

父节点:Label

LabelLevel

整型

否

2

标签层级,用于系统预置的多级标签体系。

父节点:Label

ParentLabelName

字符串

否

动物

父级标签名称。

父节点:Label

LabelAlias

字符串

否

Cat

标签别名。

父节点:Label

Language

字符串

否

zh

标签语言。

父节点:Label

CentricScore

浮点型

否

0.85

标签的中心度评分。

父节点:Label

Clips

容器

否

不涉及

命中的视频片段列表(仅视频文件)。子节点:Clip。

父节点:Label

Clip

容器

否

不涉及

单个视频片段。

父节点:Clips

子节点:TimeRange

TimeRange

整型列表

否

0 5000

视频片段的时间范围,由两个 <TimeRange> 元素组成,分别表示开始时间和结束时间,单位为毫秒。

父节点:Clip

名称

类型

是否必选

示例值

描述

FigureCount

整型

否

2

人物数量。

父节点:File

Figures

容器

否

不涉及

人脸或人物详情列表。每个子元素含人物边界框、特征向量、所属聚类等。

父节点:File

TravelClusterId

字符串

否

travel-20260520-001

旅游聚类的 ID。

父节点:File