InputFile - 智能媒体管理

名称	类型	描述	示例值
	object	用于建立索引（如 IndexFileMeta ）或更新索引（如 UpdateFileMeta ）时的文件信息。
URI	string	必填项，本次请求进行索引、进行元数据更新的文件对象地址。支持 OSS 和 PDS 的 URI 地址。 OSS 地址规则为 oss://${Bucket}/${Object}，其中`${Bucket}`为和当前项目处于同一区域(Region)的 OSS Bucket 名称，`${Object}`为包含文件扩展名的文件完整路径。 PDS 地址规则为`pds://domains/${domain}/drives/${drive}/files/${file}/revisions/${revision}`。重要不支持`HTTP`开头的地址	oss://test-bucket/test-object
CustomId	string	可选项，该文件的自定义 ID。该文件索引到数据集后，作为该行元数据的属性存储，用于和您的业务系统进行关联、对应。您可以根据业务需求传入该值，例如将某个 URI 关联到您系统内的某个 ID。推荐传入全局唯一的值。在查询时，该字段支持前缀查询和排序，详情请见字段和操作符的支持列表。	member-image-id-0001
CustomLabels	object	可选项，文件自定义标签列表。储存您业务自定义的键名、键值对信息，用于在查询时可以据此为筛选项进行检索，详情请见字段和操作符的支持列表。	{ "MemberName": "Tim", "Enabled": "True", "ItemCount": "10" }
FileHash	string	可选项，一般留空，文件哈希值。仅 URI 为 PDS 地址时需要传入。	1d9c280a7c4f67f7ef873e28449dbe17
OSSURI	string	可选项，一般留空，OSS 文件的路径。仅 URI 为 PDS 地址时可选传入。	oss://test-bucket/test-object.jpg
MediaType	string	可选项，一般留空。文件媒体类型。	image
ContentType	string	可选项，一般留空。文件内容类型（MIME Type）。	image/jpeg
Figures	array	可选项。需要更新的人物列表。用于将某个人物移除出人物分组，或修改人物分组。请参考人脸聚类能力。重要仅对 UpdateFileMeta/BatchUpdateFileMeta 接口生效。
	object	人物信息对象。
FigureId	string	人物对象 ID。	2cb3c51e-b406-4b0c-af1b-897d88e1****
FigureClusterId	string	人物聚类 ID。包括如下保留的特殊聚类 ID 命名： figure-cluster-id-independent：该人脸暂无合适的分组，后续在数据集中新增图片后进行人脸聚类操作时，该人脸可能被分入组中。 figure-cluster-id-unavailable：该人脸暂未进行过聚类操作，即在数据集中新增图片后，未进行人脸聚类。	Cluster-dbe72fec-b84c-4ab6-885b-3678e64****
FigureType	string	人物类型。目前填入固定值`face`。	face
LatLong	string	GPS 经纬度信息。	30.134390,120.074997
ProduceTime	string	照片拍摄时间。	2021-06-29T14:50:13.011643661+08:00
Title	string	文件标题。	test
Artist	string	艺术家。	Jane
AlbumArtist	string	演唱者。	Jane
Composer	string	作曲家。	Jane
Performer	string	演奏者。	Jane
Album	string	专辑。	FirstAlbum
Labels	array	智能标签列表。重要仅对 UpdateFileMeta/BatchUpdateFileMeta 接口生效。
	Label	智能标签对象。
Addresses	array	地址信息列表。重要仅对 UpdateFileMeta/BatchUpdateFileMeta 接口生效。
	Address	地址信息。

object

用于建立索引（如 IndexFileMeta ）或更新索引（如 UpdateFileMeta ）时的文件信息。

URI

string

必填项，本次请求进行索引、进行元数据更新的文件对象地址。支持 OSS 和 PDS 的 URI 地址。

OSS 地址规则为 oss://${Bucket}/${Object}，其中${Bucket}为和当前项目处于同一区域(Region)的 OSS Bucket 名称，${Object}为包含文件扩展名的文件完整路径。

PDS 地址规则为pds://domains/${domain}/drives/${drive}/files/${file}/revisions/${revision}。

重要不支持HTTP开头的地址

oss://test-bucket/test-object

CustomId

string

可选项，该文件的自定义 ID。该文件索引到数据集后，作为该行元数据的属性存储，用于和您的业务系统进行关联、对应。您可以根据业务需求传入该值，例如将某个 URI 关联到您系统内的某个 ID。推荐传入全局唯一的值。

在查询时，该字段支持前缀查询和排序，详情请见字段和操作符的支持列表。

member-image-id-0001

CustomLabels

object

可选项，文件自定义标签列表。储存您业务自定义的键名、键值对信息，用于在查询时可以据此为筛选项进行检索，详情请见字段和操作符的支持列表。

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

FileHash

string

可选项，一般留空，文件哈希值。仅 URI 为 PDS 地址时需要传入。

1d9c280a7c4f67f7ef873e28449dbe17

OSSURI

string

可选项，一般留空，OSS 文件的路径。仅 URI 为 PDS 地址时可选传入。

oss://test-bucket/test-object.jpg

MediaType

string

可选项，一般留空。文件媒体类型。

image

ContentType

string

可选项，一般留空。文件内容类型（MIME Type）。

image/jpeg

Figures

array

可选项。需要更新的人物列表。用于将某个人物移除出人物分组，或修改人物分组。请参考人脸聚类能力。

重要仅对 UpdateFileMeta/BatchUpdateFileMeta 接口生效。

object

人物信息对象。

FigureId

string

人物对象 ID。

2cb3c51e-b406-4b0c-af1b-897d88e1****

FigureClusterId

string

人物聚类 ID。包括如下保留的特殊聚类 ID 命名：

figure-cluster-id-independent：该人脸暂无合适的分组，后续在数据集中新增图片后进行人脸聚类操作时，该人脸可能被分入组中。
figure-cluster-id-unavailable：该人脸暂未进行过聚类操作，即在数据集中新增图片后，未进行人脸聚类。

Cluster-dbe72fec-b84c-4ab6-885b-3678e64****

FigureType

string

人物类型。目前填入固定值face。

face

LatLong

string

GPS 经纬度信息。

30.134390,120.074997

ProduceTime

string

照片拍摄时间。

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

Title

string

文件标题。

test

Artist

string

艺术家。

Jane

AlbumArtist

string

演唱者。

Jane

Composer

string

作曲家。

Jane

Performer

string

演奏者。

Jane

Album

string

专辑。

FirstAlbum

Labels

array

智能标签列表。

重要仅对 UpdateFileMeta/BatchUpdateFileMeta 接口生效。

Label

智能标签对象。

Addresses

array

地址信息列表。

重要仅对 UpdateFileMeta/BatchUpdateFileMeta 接口生效。

Address

地址信息。