Jalankan API SemanticQuery untuk mencari dataset IMM dengan bahasa alami - Intelligent Media Management - Alibaba Cloud - Intelligent Media Management

Melakukan pencarian kueri berbasis semantik pada metadata dalam set data menggunakan bahasa alami.

Deskripsi operasi

Catatan

Sebelum menggunakan antarmuka ini, pastikan Anda telah memahami sepenuhnya metode penagihan dan harga produk Intelligent Media Management. Setiap permintaan ke antarmuka ini menghasilkan satu biaya pemahaman semantik dan satu biaya kueri.
Sebelum memanggil antarmuka ini, pastikan Anda telah mengindeks file ke dalam set data (Dataset) melalui pengikatan (CreateBinding) atau pengindeksan aktif (IndexFileMeta atau BatchIndexFileMeta).
Hasil yang dikembalikan hanya berupa contoh. Bergantung pada konfigurasi templat alur kerja, kategori dan konten informasi metadata file yang diperoleh mungkin berbeda dari contoh. Jika Anda memiliki pertanyaan, silakan bergabung dengan kelompok DingTalk untuk memberikan umpan balik. Untuk nomor kelompok DingTalk, lihat Hubungi Kami.

Batas Penggunaan

Maksimal 100 rekaman file dikembalikan per kueri.
Kueri paginasi tidak didukung.
Pemahaman bahasa alami tidak dijamin sepenuhnya akurat.
Fitur ini tidak didukung di wilayah AS (Silicon Valley) dan AS (Virginia).

Penggunaan

Gunakan kata kunci bahasa alami untuk mencari file dalam set data. Saat ini, informasi kunci yang dapat dipahami mencakup label (Labels.LabelName), waktu (ProduceTime), dan lokasi (Address.AddressLine). Misalnya, saat melakukan kueri dengan Scenery of Hangzhou in 2023 sebagai kondisi, kondisi tersebut akan dilakukan pemisahan secara cerdas menjadi tiga kondisi berikut, dan file yang memenuhi semua kondisi tersebut secara bersamaan akan dikembalikan:

ProduceTime: Dari pukul 00:00 pada 1 Januari 2023 hingga akhir 31 Desember 2023
Address.AddressLine: Mengandung kata kunci Hangzhou
Labels.LabelName: Mengandung label Scenery

Bersama dengan konfigurasi templat alur kerja, ketika templat berisi operator ImageEmbeddingExtraction, permintaan pencarian ini akan menyediakan pencarian berbasis konten gambar; yaitu, konten Query yang Anda masukkan juga akan diinterpretasikan sebagai konten yang terkandung dalam gambar, sehingga memungkinkan pengambilan gambar secara cerdas.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

imm:SemanticQuery

list

*Dataset

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}/dataset/{#DatasetName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
NextToken	string	No	Parameter ini tidak lagi disediakan.	预留，暂不支持
MaxResults	integer	No	Jumlah maksimum rekaman data yang dibaca dalam permintaan ini. Rentang: (0,100].	20
ProjectName	string	Yes	Nama proyek.	test-project
DatasetName	string	Yes	Nama set data.	test-dataset
Query	string	No	Penting Salah satu dari parameter ini atau parameter SourceURI harus diatur ke nilai yang tidak kosong. Konten untuk melakukan pencarian semantik.	2021年4月杭州的风景
WithFields	array	No	Mengembalikan hanya nilai bidang tertentu, bukan semua bidang metadata yang ada. Dapat digunakan untuk mengurangi ukuran struktur yang dikembalikan. Jika tidak diisi atau dibiarkan kosong, semua bidang akan dikembalikan.
	string	No	Mengembalikan hanya nilai bidang tertentu, bukan semua bidang metadata yang ada. Dapat digunakan untuk mengurangi ukuran struktur yang dikembalikan. Jika tidak diisi atau dibiarkan kosong, semua bidang akan dikembalikan.	["URI", "Filename"]
MediaTypes	array	No	Tipe media yang akan dicari. Jika dibiarkan kosong, nilai default adalah:
	string	No	Nilai enumerasi. Saat ini hanya mendukung: image.	["image"]
SourceURI	string	No	Penting Salah satu dari parameter ini atau parameter Query harus diatur ke nilai yang tidak kosong. Parameter ini saat ini hanya valid ketika tipe pencarian ditentukan sebagai image dan set data dikonfigurasi dengan templat alur kerja yang terkait dengan pencarian gambar berbasis gambar. Alamat penyimpanan data sumber yang digunakan untuk pengambilan. Alamat penyimpanan mendukung alamat URI OSS. Alamat OSS mengikuti format oss://${Bucket}/${Object}, di mana ${Bucket} adalah nama Bucket OSS di wilayah yang sama dengan proyek saat ini, dan ${Object} adalah jalur file lengkap termasuk ekstensi file. Jika Anda perlu mengonfigurasi templat alur kerja yang sesuai, silakan hubungi kami.	oss://test-bucket/test-object

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID Permintaan dari permintaan saat ini.	2C5C1E0F-D8B8-4DA0-8127-EC32C771****
Files	array	Daftar file.
	File	Informasi file.

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.