Image Search:Tambahkan gambar

Konsol

1. Masuk ke Image Search console.

2. Di panel navigasi sebelah kiri, pilih tipe layanan. Topik ini menggunakan product image search sebagai contoh.

   Untuk informasi selengkapnya mengenai tipe layanan, lihat Layanan.

3. Klik instans target.

   Pada daftar instans, klik instance ID instans target.

4. Pilih Add Image.

   Konfigurasikan parameter dan klik OK. Setelah Anda berhasil mengirimkan gambar, respons JSON mentah akan muncul di sisi kanan. Respons yang berhasil mencakup code: 0, message: "success", dan picInfo, yang berisi categoryId (ID kategori) dan region (koordinat bidang subjek). Tabel berikut menjelaskan parameter tersebut.

   Parameter	Parameter API	Deskripsi	Wajib
   Product ID	ProductId	ID unik produk. Panjangnya dapat mencapai 256 karakter.	Ya
   Image name	PicName	Nama gambar. Panjangnya dapat mencapai 256 karakter. Catatan Kombinasi product ID dan image name secara unik mengidentifikasi sebuah gambar. Penting Jika Anda menambahkan gambar dengan product ID dan image name yang sama dengan gambar yang sudah ada, gambar baru akan menimpa gambar yang sudah ada, terlepas dari apakah konten gambarnya berbeda atau tidak.	Ya
   Upload image	PicContent	Konten gambar yang dienkripsi Base64. Gambar harus memenuhi persyaratan berikut: Ukuran gambar tidak boleh melebihi 4 MB. Format yang didukung: PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF, dan PPM. Timeout transfer tidak boleh melebihi 5 detik. Untuk product image search, generic image search, lebar dan tinggi gambar harus antara 100 hingga 4.096 piksel. Gambar tidak boleh berisi informasi rotasi. Penting Parameter ini memerlukan konten gambar yang dienkripsi Base64. Jika Anda ingin menambahkan gambar melalui URL, lihat kode contoh untuk operasi Add SDK.	Ya
   Image Subject Recognition	Crop	Mengaktifkan atau menonaktifkan pengenalan subjek.	Ya
   Recognition method	N/A	Metode untuk pengenalan subjek: Automatic Recognition: Sistem secara otomatis mengenali subjek dan menggunakan subjek yang dikenali untuk pencarian. Tanggapan mencakup hasil pengenalan. Define the main subject area: Ini mengaktifkan pengenalan subjek dan memungkinkan Anda menentukan area subjek. Jika Anda tidak menentukan area subjek, layanan akan mencari seluruh gambar.	Ya
   Image category	CategoryId	Kategori gambar. Anda dapat menetapkan kategori saat menambahkan gambar. Catatan Layanan product image search memiliki fitur prediksi kategori otomatis bawaan. Jika Anda tidak menentukan parameter ini, Image Search secara otomatis memprediksi kategori gambar dan mengindeksnya. Kategori yang diprediksi dikembalikan dalam tanggapan. Saat pencarian, layanan product image search juga memprediksi kategori gambar kueri dan mencari dalam kategori tersebut untuk mempersempit cakupan dan meningkatkan akurasi. Untuk layanan product image search, kami merekomendasikan menggunakan fitur prediksi kategori otomatis bawaan. Untuk daftar kategori, lihat Referensi kategori. Penting Jika Anda menentukan kategori saat menambahkan gambar, Anda juga harus menentukan kategori yang sama saat melakukan pencarian. Jika tidak, pencarian menggunakan gambar asli mungkin gagal menemukannya.	Tidak
   Custom content	CustomContent	Konten yang ditentukan pengguna, panjang maksimal 4.096 karakter. Catatan Hasil pencarian mencakup nilai ini. Anda dapat menggunakan bidang ini untuk menyimpan URL gambar atau informasi tambahan lainnya guna menghubungkan gambar dengan data bisnis Anda.	Tidak
   Integer attribute	IntAttr	Atribut integer yang digunakan untuk memfilter hasil pencarian. Atribut ini disertakan dalam hasil pencarian. Catatan Gunakan atribut integer dalam kondisi filter untuk memfilter hasil pencarian. Untuk informasi selengkapnya, lihat Kondisi filter.	Tidak
   Integer attribute 2	IntAttr2		Tidak
   Integer attribute 3	IntAttr3		Tidak
   Integer attribute 4	IntAttr4		Tidak
   String attribute	StrAttr	Atribut string, panjang maksimal 128 karakter. Digunakan untuk memfilter hasil pencarian. Catatan Gunakan atribut string dalam kondisi filter untuk memfilter hasil pencarian. Untuk informasi selengkapnya, lihat Kondisi filter. Karakter khusus seperti \, ¥, $, &, dan % tidak didukung.	Tidak
   String attribute 2	StrAttr2		Tidak
   String attribute 3	StrAttr3		Tidak
   String attribute 4	StrAttr4		Tidak

5. Klik OK untuk menambahkan gambar.

API

Anda dapat memanggil operasi ini dengan mengirimkan permintaan HTTP atau HTTPS. Setiap permintaan harus diautentikasi menggunakan signature dan badan permintaan harus diformat sesuai ketentuan. QPS default untuk menambahkan gambar melalui API adalah 5. Untuk informasi selengkapnya, lihat AddImage.

SDK

Image Search menyediakan SDK untuk berbagai bahasa pemrograman. Penggunaan SDK menghilangkan kebutuhan untuk menangani tugas-tugas rumit seperti verifikasi signature dan pemformatan badan permintaan. Metode ini direkomendasikan untuk menambahkan sejumlah kecil gambar secara real-time. Batas QPS adalah 1 untuk instans dengan kapasitas 100.000 gambar dan 5 untuk semua tipe instans lainnya. Untuk informasi selengkapnya, lihat operasi Add.

Operasi batch

Image Search terintegrasi dengan Alibaba Cloud Object Storage Service (OSS), memungkinkan Anda mengimpor gambar secara batch dari bucket OSS hanya dalam beberapa langkah sederhana. Metode ini cocok untuk impor data offline skala besar (jutaan gambar). Untuk informasi selengkapnya, lihat Lakukan operasi batch.