All Products
Search
Document Center

Image Search:Tambahkan gambar

Last Updated:Jul 06, 2025

Topik ini menjelaskan empat metode yang dapat digunakan untuk menambahkan gambar ke Image Search. Anda dapat menggunakan konsol Image Search, memanggil operasi AddImage, menggunakan SDK Image Search, atau memanfaatkan fitur operasi batch. Gunakan konsol Image Search jika ingin mencoba cara menambahkan gambar. Gunakan SDK Image Search untuk menambahkan sejumlah kecil gambar secara real-time. Untuk menambahkan jutaan gambar sekaligus, gunakan fitur operasi batch. Pilih metode yang sesuai dengan kebutuhan bisnis Anda.

Prasyarat

Instance Image Search telah dibuat. Untuk informasi lebih lanjut, lihat Aktifkan Image Search.

Gunakan konsol Image Search

  1. Masuk ke Konsol Image Search.

  2. Di panel navigasi di sebelah kiri, pilih jenis layanan. Dalam contoh ini, Product Search Instances dipilih.

    Untuk informasi lebih lanjut tentang jenis layanan, lihat bagian Isi Layanan dari topik "Apa itu Image Search?"image

  3. Klik ID instance yang ingin dikelola.

    image

  4. Pada halaman Detail Instance, klik tab Add Image.

    imagePengaturan parameter tambah gambar adalah sebagai berikut.

    Parameter

    Nama parameter dalam operasi AddImage

    Deskripsi

    Diperlukan

    ID Produk

    ProductId

    ID unik produk. ID dapat memiliki panjang hingga 256 karakter.

    Ya

    Nama Gambar

    PicName

    Nama gambar. Nama dapat memiliki panjang hingga 256 karakter.

    Catatan

    Gambar diidentifikasi secara unik oleh kombinasi ID produk dan nama gambar.

    Penting

    Jika Anda menambahkan gambar yang ID produk dan nama gambarnya sama dengan gambar yang sudah ada, gambar baru akan menimpa gambar yang sudah ada.

    Ya

    Unggah Gambar

    PicContent

    File gambar yang akan diunggah. File gambar dikodekan dalam Base64. Gambar yang akan diunggah harus memenuhi persyaratan berikut:

    • Ukuran file gambar tidak boleh melebihi 4 MB.

    • Gambar dalam salah satu format berikut: PNG, JPG, JPEG, BMP, GIF, WebP, TIFF, dan PPM.

    • Batas waktu transmisi tidak boleh melebihi 5 detik.

    • Untuk pencarian gambar produk, pencarian gambar umum, pencarian gambar furnitur dan perlengkapan rumah tangga, serta pencarian gambar perangkat keras industri, panjang dan lebar gambar harus berkisar antara 100 piksel hingga 4.096 piksel.

    • Gambar tidak boleh mengandung pengaturan rotasi.

    Penting

    Parameter ini mengharuskan Anda untuk langsung mengunggah file gambar yang dikodekan dalam Base64. Untuk informasi lebih lanjut tentang cara mengunggah gambar dengan menentukan URL gambar, lihat bagian Tambah dari topik "SDK for Java".

    Ya

    Pengenalan Subjek Gambar

    Crop

    Menentukan apakah akan mengenali subjek dalam gambar dan mencari gambar berdasarkan subjek yang dikenali.

    Ya

    Metode Pengenalan

    N/A

    Metode untuk mengenali subjek dalam gambar. Nilai valid:

    • Pengenalan Otomatis: Jika Anda memilih opsi ini, sistem mengenali subjek dan mencari gambar berdasarkan subjek yang dikenali. Anda dapat memperoleh hasil pengenalan dalam respons.

    • Tentukan area subjek utama: Anda dapat menentukan area untuk pengenalan subjek. Jika Anda tidak menentukan area subjek, sistem mencari gambar berdasarkan seluruh gambar.

    Ya

    Kategori Gambar

    CategoryId

    Kategori gambar. Anda dapat menentukan kategori gambar saat menambahkan gambar.

    Catatan
    1. Fitur prediksi kategori otomatis bawaan disediakan untuk pencarian gambar produk. Jika Anda tidak menentukan kategori untuk gambar, sistem secara otomatis memprediksi kategori gambar dan mengindeks kategori yang diprediksi ke dalam mesin. Hasil prediksi dikembalikan dalam respons.

    2. Saat melakukan pencarian gambar produk, sistem juga secara otomatis memprediksi kategori gambar yang Anda unggah dan mencari gambar berdasarkan kategori yang diprediksi untuk mempersempit ruang lingkup pencarian dan meningkatkan akurasi pencarian.

    3. Untuk pencarian gambar produk, kami sarankan Anda menggunakan fitur prediksi kategori otomatis default.

    4. Untuk pencarian gambar kain, pencarian gambar merek, pencarian gambar umum, pencarian gambar hak cipta, pencarian gambar perangkat keras industri, dan pencarian gambar furnitur dan perlengkapan rumah tangga, 88888888 dikembalikan sebagai ID kategori dalam respons terlepas dari apakah kategori ditentukan.

    5. Untuk informasi lebih lanjut tentang kategori, lihat Referensi Kategori.

    Penting

    Jika Anda menentukan kategori untuk gambar saat mengunggah gambar, Anda harus menentukan kategori yang sama untuk pencarian gambar saat Anda mencari gambar. Jika tidak, gambar sumber dari gambar yang Anda unggah tidak dapat dicari.

    Tidak

    Konten Kustom

    CustomContent

    Konten yang ditentukan pengguna. Nilainya dapat memiliki panjang hingga 4.096 karakter.

    Catatan

    Konten yang ditentukan pengguna untuk gambar secara otomatis dikembalikan dalam hasil pencarian. Anda dapat menambahkan informasi seperti URL gambar dan deskripsi gambar menggunakan parameter ini.

    Tidak

    Atribut Integer

    IntAttr

    Atribut bertipe integer dari gambar. Atribut ini dapat digunakan untuk menyaring gambar saat Anda mencari gambar.

    Catatan

    Saat Anda mencari gambar, Anda dapat menentukan parameter Atribut Integer dan kondisi filter untuk menyaring gambar. Untuk informasi lebih lanjut, lihat Cari gambar dengan menentukan kondisi filter.

    Tidak

    Atribut Integer2

    IntAttr2

    Tidak

    Atribut Integer3

    IntAttr3

    Atribut Integer4

    IntAttr4

    Atribut String

    StrAttr

    Atribut bertipe string dari gambar. Nilainya dapat memiliki panjang hingga 128 karakter. Atribut ini dapat digunakan untuk menyaring gambar saat Anda mencari gambar.

    Catatan
    • Saat Anda mencari gambar, Anda dapat menentukan parameter Atribut String dan kondisi filter untuk menyaring gambar. Untuk informasi lebih lanjut, lihat Cari gambar dengan menentukan kondisi filter.

    • Karakter khusus seperti \ ¥ $&% tidak didukung

    Tidak

    Atribut String2

    StrAttr2

    Tidak

    Atribut String3

    StrAttr3

    Atribut String4

    StrAttr4

  5. Klik OK.

Panggil operasi AddImage

Anda dapat menambahkan gambar dengan mengirimkan permintaan melalui HTTP atau HTTPS untuk memanggil operasi AddImage dari Image Search. Dalam metode ini, tanda tangan digunakan untuk mengotentikasi peminta, dan badan permintaan harus dikirim dalam format yang ditentukan. Batas default queries-per-second (QPS) untuk memanggil operasi AddImage adalah 5 QPS. Untuk informasi lebih lanjut, lihat AddImage.

Gunakan SDK Image Search

Image Search menyediakan SDK versi berbeda. Jika Anda menggunakan SDK Image Search untuk menambahkan gambar, Anda tidak perlu khawatir tentang masalah seperti verifikasi tanda tangan dan kepatuhan terhadap format badan permintaan. Jika Anda ingin menambahkan sejumlah kecil gambar secara real-time, disarankan untuk menggunakan SDK Image Search. Jika Anda menambahkan gambar menggunakan SDK Image Search, batas QPS adalah 1 QPS untuk instance dengan spesifikasi kapasitas gambar 0,1 juta gambar, dan 5 QPS untuk instance dengan spesifikasi kapasitas gambar lainnya. Untuk informasi lebih lanjut, lihat bagian Tambah dari topik "SDK for Java".

Gunakan fitur operasi batch

Setelah Anda menghubungkan Image Search ke Object Storage Service (OSS), Anda dapat mengimpor beberapa gambar dari OSS ke Image Search sekaligus. Metode ini cocok untuk skenario di mana Anda ingin menambahkan jutaan gambar sekaligus. Untuk informasi lebih lanjut, lihat Lakukan Operasi Batch.