全部產品
Search
文件中心

:InputFile

更新時間:Feb 26, 2026

名稱

類型

描述

樣本值

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

人物物件識別碼。

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

FigureClusterId

string

人物聚類別識別碼。包括如下保留的特殊聚類別識別碼 命名:

  • 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

地址資訊。