Menanyakan metadata dalam suatu dataset menggunakan bahasa alami.
Deskripsi operasi
Perhatian
-
Pastikan Anda telah memahami sepenuhnya mekanisme penagihan dan harga produk Intelligent Media Management sebelum menggunakan API ini. Setiap permintaan ke API ini dikenai dua jenis biaya: biaya pemahaman semantik dan biaya kueri, masing-masing satu kali.
-
Sebelum memanggil API ini, pastikan Anda telah mengindeks file ke dalam dataset melalui metode binding (CreateBinding) atau pengindeksan aktif (IndexFileMeta atau BatchIndexFileMeta).
-
Hasil yang ditampilkan bersifat contoh. Jenis dan isi informasi metadata file yang diperoleh dapat berbeda tergantung pada konfigurasi templat alur kerja. Jika ada pertanyaan, silakan bergabung dengan grup DingTalk untuk memberikan masukan; nomor grup DingTalk tersedia di Kontak Kami.
Batasan Penggunaan
-
Setiap kueri paling banyak mengembalikan informasi 100 file.
-
Tidak mendukung kueri dengan pagination (halaman berikutnya).
-
Pemahaman bahasa alami tidak menjamin akurasi sempurna.
-
Fitur ini tidak didukung di wilayah AS (Silicon Valley) dan AS (Virginia).
Cara Penggunaan
Gunakan kata kunci dalam bahasa alami untuk mencari dan menanyakan file dalam dataset. Saat ini, informasi kunci yang didukung mencakup tag (Labels.LabelName), waktu (ProduceTime), dan lokasi (Address.AddressLine). Sebagai contoh, jika Anda melakukan kueri dengan kondisi 2023 年杭州的风景, sistem akan secara cerdas membaginya menjadi tiga kondisi berikut dan mencari file yang memenuhi ketiganya secara bersamaan:
-
ProduceTime: dari pukul 00.00 tanggal 1 Januari 2023 hingga akhir tanggal 31 Desember 2023
-
Address.AddressLine: mengandung kata kunci
杭州 -
Labels.LabelName: memiliki tag
风景
Jika dikombinasikan dengan konfigurasi templat alur kerja yang mencakup operator ImageEmbeddingExtraction, permintaan pencarian ini akan menyediakan pencarian berbasis konten gambar. Artinya, konten Query yang Anda masukkan juga akan dipahami sebagai konten yang terdapat dalam gambar, sehingga memungkinkan pencarian cerdas terhadap gambar.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
imm:SemanticQuery |
list |
*Dataset
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| NextToken |
string |
No |
Parameter ini tidak lagi tersedia. |
预留,暂不支持 |
| MaxResults |
integer |
No |
Jumlah maksimum entri yang dikembalikan. Nilai valid: 1 hingga 1000. |
20 |
| ProjectName |
string |
Yes |
Nama proyek. |
test-project |
| DatasetName |
string |
Yes |
Nama dataset. |
test-dataset |
| Query |
string |
No |
Konten kueri yang Anda masukkan. |
2021年4月杭州的风景 |
| WithFields |
array |
No |
Catatan
Salah satu dari parameter ini atau parameter SourceURI harus ditentukan. Konten kueri yang Anda masukkan. |
|
|
string |
No |
Bidang yang ingin Anda sertakan dalam respons. Menyertakan hanya bidang metadata yang diperlukan dapat membantu mengurangi ukuran respons. Jika Anda tidak menentukan parameter ini atau mengatur nilainya ke null, semua bidang metadata yang ada akan dikembalikan. |
["URI", "Filename"] |
|
| MediaTypes |
array |
No |
Jenis media yang ingin Anda tanyakan. Nilai default: ["image"] |
|
|
string |
No |
Jenis media yang ingin Anda tanyakan. Tetapkan nilainya ke image. |
["image"] |
|
| SourceURI |
string |
No |
Catatan
Salah satu dari parameter ini atau parameter Query harus ditentukan. Parameter ini hanya berlaku untuk pencarian gambar pada dataset yang dikonfigurasi dengan alur kerja pencarian berdasarkan gambar. URI data sumber untuk pengambilan. URI harus dalam format oss://${Bucket}/${Object}. ${Bucket} menentukan nama Bucket OSS yang berada di wilayah yang sama dengan proyek saat ini. ${Object} menentukan path lengkap file termasuk ekstensi nama file. Hubungi kami jika Anda perlu mengonfigurasi templat alur kerja. |
oss://test-bucket/test-object |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Skema Respons |
||
| RequestId |
string |
ID permintaan. |
2C5C1E0F-D8B8-4DA0-8127-EC32C771**** |
| Files |
array |
File-file tersebut. |
|
| File |
Informasi file. |
Contoh
Respons sukses
JSONformat
{
"RequestId": "2C5C1E0F-D8B8-4DA0-8127-EC32C771****",
"Files": [
{
"OwnerId": "102321002467****",
"ProjectName": "test-project",
"DatasetName": "test-dataset",
"ObjectType": "file",
"ObjectId": "75d5de2c50754e3dadd5c35dbca5f9949369e37eb342a73821f690c94c36c7f7",
"UpdateTime": "2021-06-29T14:50:13.011643661+08:00",
"CreateTime": "2021-06-29T14:50:13.011643661+08:00",
"URI": "oss://test-bucket/test-object.jpg",
"OSSURI": "oss://examplebucket/sampleobject.jpg",
"Filename": "sampleobject.jpg",
"MediaType": "image",
"ContentType": "image/jpeg",
"Size": 1000,
"FileHash": "1d9c280a7c4f67f7ef873e28449dbe17",
"FileModifiedTime": "2021-06-29T14:50:13.011643661+08:00",
"FileCreateTime": "2021-06-29T14:50:13.011643661+08:00",
"FileAccessTime": "2021-06-29T14:50:13.011643661+08:00",
"ProduceTime": "2021-06-29T14:50:13.011643661+08:00",
"LatLong": "30.134390,120.074997",
"Timezone": "\"\"",
"Addresses": [
{
"Language": "zh-Hans",
"AddressLine": "中国浙江省杭州市余杭区文一西路969号",
"Country": "中国",
"Province": "浙江省",
"City": "杭州市",
"District": "余杭区",
"Township": "文一西路"
}
],
"TravelClusterId": "-",
"Orientation": 0,
"Figures": [
{
"FigureId": "868a9e74-cde5-4c7a-9013-28bb984****",
"FigureConfidence": 1,
"FigureClusterId": "Cluster-dbe72fec-b84c-4ab6-885b-3678e64****",
"FigureClusterConfidence": 1,
"FigureType": "face",
"Age": 29,
"AgeSD": 5,
"Gender": "female",
"GenderConfidence": 1,
"Emotion": "happiness",
"EmotionConfidence": 0.70784568786621,
"FaceQuality": 0.960875928401947,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
},
"Mouth": "close",
"MouthConfidence": 1,
"Beard": "none",
"BeardConfidence": 1,
"Hat": "none",
"HatConfidence": 1,
"Mask": "none",
"MaskConfidence": 1,
"Glasses": "none",
"GlassesConfidence": 0.8,
"Sharpness": 0.7,
"Attractive": 0.96,
"HeadPose": {
"Pitch": 18.385589599609375,
"Roll": 4.204030513763428,
"Yaw": 2.4945924282073975
}
}
],
"FigureCount": 10,
"Labels": [
{
"Language": "zh-Hans",
"LabelName": "椅子",
"LabelLevel": 2,
"LabelConfidence": 0.95,
"ParentLabelName": "家具",
"CentricScore": 0.877
}
],
"Title": "test",
"ImageWidth": 270,
"ImageHeight": 500,
"EXIF": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
"ImageScore": {
"OverallQualityScore": 0.736
},
"CroppingSuggestions": [
{
"AspectRatio": "2:3",
"Confidence": 0.742,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
}
}
],
"OCRContents": [
{
"Language": "zh-hans",
"Contents": "欢迎使用智能媒体管理",
"Confidence": 0.8254936695098877,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
}
}
],
"VideoWidth": 1080,
"VideoHeight": 1920,
"VideoStreams": [
{
"Index": 0,
"Language": "en",
"CodecName": "h264",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Profile": "High",
"CodecTimeBase": "1373627/83160000",
"CodecTagString": "avc1",
"CodecTag": "0x31637661",
"Width": 1280,
"Height": 720,
"HasBFrames": 2,
"SampleAspectRatio": "1:1",
"DisplayAspectRatio": "16:9",
"PixelFormat": "yuv420p",
"Level": 40,
"FrameRate": "25/1",
"AverageFrameRate": "25/1",
"TimeBase": "1/12800",
"StartTime": 0,
"Duration": 22.88,
"Bitrate": 5407765,
"FrameCount": 572,
"Rotate": "90",
"BitDepth": 8,
"ColorSpace": "bt709",
"ColorRange": "tv",
"ColorTransfer": "bt709",
"ColorPrimaries": "bt709"
}
],
"Subtitles": [
{
"Index": 2,
"Language": "en",
"CodecName": "mov_text",
"CodecLongName": "MOV text",
"CodecTagString": "tx3g",
"CodecTag": "0x67337874",
"StartTime": 0,
"Duration": 71.378,
"Bitrate": 74,
"Content": "欢迎",
"Width": 600,
"Height": 30
}
],
"AudioStreams": [
{
"Index": 1,
"Language": "en",
"CodecName": "aac",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecTimeBase": "1/44100",
"CodecTagString": "mp4a",
"CodecTag": "0x6134706d",
"TimeBase": "1/48000",
"StartTime": 0.0235,
"Duration": 3.690667,
"Bitrate": 320087,
"FrameCount": 173,
"Lyric": "test",
"SampleFormat": "fltp",
"SampleRate": 48000,
"Channels": 2,
"ChannelLayout": "stereo"
}
],
"Artist": "Jane",
"AlbumArtist": "Jane",
"AudioCovers": [
{
"ImageWidth": 500,
"ImageHeight": 820,
"EXIF": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"}}",
"ImageScore": {
"OverallQualityScore": 0.736
},
"CroppingSuggestions": [
{
"AspectRatio": "2:3",
"Confidence": 0.742
}
],
"OCRContents": [
{
"Language": "zh-hans",
"Contents": "欢迎使用智能媒体管理",
"Confidence": 0.8254936695098877
}
]
}
],
"Composer": "Jane",
"Performer": "Jane",
"Language": "eng",
"Album": "FirstAlbum",
"PageCount": 5,
"ETag": "\"1D9C280A7C4F67F7EF873E28449****\"",
"CacheControl": "no-cache",
"ContentDisposition": "attachment; filename =test.jpg",
"ContentEncoding": "UTF-8",
"ContentLanguage": "zh-CN",
"AccessControlAllowOrigin": "https://aliyundoc.com",
"AccessControlRequestMethod": "PUT",
"ServerSideEncryptionCustomerAlgorithm": "SM4",
"ServerSideEncryption": "AES256",
"ServerSideDataEncryption": "SM4",
"ServerSideEncryptionKeyId": "9468da86-3509-4f8d-a61e-6eab1eac****",
"OSSStorageClass": "Standard",
"OSSCRC64": "559890638950338001",
"ObjectACL": "default",
"ContentMd5": "HZwoCnxPZ/fvhz4oRJ2+Fw==",
"OSSUserMeta": {
"key": "val"
},
"OSSTaggingCount": 2,
"OSSTagging": {
"key": "val"
},
"OSSExpiration": "2120-01-01T12:00:00.000Z",
"OSSVersionId": "CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0****",
"OSSDeleteMarker": "CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****",
"OSSObjectType": "Normal",
"CustomId": "\t\nmember-image-id-0001",
"CustomLabels": {
"MemberName": "Tim",
"Enabled": "True",
"ItemCount": "10"
},
"StreamCount": 1,
"ProgramCount": 1,
"FormatName": "mov",
"FormatLongName": "QuickTime / MOV",
"StartTime": 0,
"Bitrate": 13091201,
"Duration": 15.263,
"SemanticTypes": [
"content"
],
"Elements": [
{
"ElementContents": [
{
"Type": "text",
"Content": "文本片段",
"URL": "http://aliyun.com",
"TimeRange": [
500
]
}
],
"ObjectId": "id1",
"ElementType": "title - 标题; image - 图片 ; table - 表格 ; narrative-text - 正文",
"SemanticSimilarity": 0.8,
"ElementRelations": [
{
"Type": "child,parent",
"ObjectId": "id1"
}
]
}
],
"SceneElements": [
{
"TimeRange": [
100
],
"FrameTimes": [
30
],
"VideoStreamIndex": 0
}
],
"OCRTexts": "阿里云IMM",
"Reason": "[InternalError] The request has been failed due to some unknown error. status: 500, requestId: CC5ACFBD-BB7A-496D-A9D6-****",
"ObjectStatus": "Indexed",
"Insights": {
"Video": {
"Description": "无。",
"Caption": "视频中展示了两个不同场景:一个是静止的白色盘子、黑色瓶子和透明玻璃杯,另一个是手拿着标有“YEZOLU”的洗发水瓶在浴室中缓慢上移。"
},
"Image": {
"Caption": "无。",
"Description": "图片中有一人,穿着深色西装外套,内搭白色衬衫。背景为渐变的浅蓝色至灰色。"
}
}
}
]
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.