Fitur Pencarian berdasarkan gambar memungkinkan model mencari di Internet gambar yang secara visual mirip dengan gambar input, lalu menganalisis hasil pencarian tersebut untuk melakukan inferensi. Fitur ini berguna dalam skenario seperti menemukan produk serupa atau melacak asal konten visual.
Cara menggunakan
Anda dapat memanggil fitur Pencarian berdasarkan gambar melalui Responses API dengan menambahkan alat image_search ke parameter tools, serta mengirimkan gambar dalam parameter input dalam format multimodal.
inputharus berisi konten gambar. Kirimkan URL gambar menggunakan tipeinput_image. Anda juga dapat menyertakan teks menggunakan tipeinput_textuntuk memberikan informasi tambahan bagi pencarian.
Model yang didukung
Model yang direkomendasikan
Untuk performa pemanggilan alat yang optimal, gunakan model berikut:
Qwen-Plus: seri Qwen3.7-Plus, seri Qwen3.6-Plus, seri Qwen3.5-Plus
Qwen-Max: seri Qwen3.8-Max, qwen3.7-max-2026-06-08
qwen3.8-27b
Model lainnya
Model berikut juga mendukung alat ini, tetapi performanya tidak sebaik model yang direkomendasikan.
- Qwen-Flash: seri Qwen3.7-Flash, seri Qwen3.6-Flash, seri Qwen3.5-Flash
Mulai
Anda dapat menjalankan kode berikut untuk memanggil fitur Pencarian berdasarkan gambar melalui Responses API dan mencari gambar serupa atau terkait berdasarkan gambar input.
Sebelum memulai, dapatkan Kunci API dan konfigurasikan Kunci API sebagai variabel lingkungan.
Ganti image_url dalam kode contoh dengan URL gambar yang dapat diakses publik.
Keluaran streaming
Alat Pencarian berdasarkan gambar memiliki waktu pemrosesan yang panjang. Anda dapat mengaktifkan keluaran streaming untuk mengambil hasil antara secara real time.
Penagihan
Penagihan mencakup aspek-aspek berikut:
- Biaya pemanggilan model: Hasil dari pencarian gambar ditambahkan ke prompt, sehingga meningkatkan jumlah token input untuk model. Anda dikenai biaya berdasarkan tarif standar model. Untuk detail harga, lihat Konsol Model Studio.
- Biaya pemanggilan alat: Anda dikenai biaya per 1.000 kali pemanggilan. Biayanya adalah $8,00 untuk penerapan di wilayah Singapura, sedangkan biaya untuk penerapan di North China 2 (Beijing) adalah $6,881.
FAQ
T: Format gambar dan metode input apa saja yang didukung?
J: Untuk informasi lebih lanjut, lihat Batasan gambar dan Metode input file.
SDK OpenAI tidak mendukung pengiriman path file lokal.
T: Berapa banyak gambar yang dapat dikirim?
J: Jumlah gambar yang dapat dikirim dibatasi oleh panjang input maksimum model. Jumlah total token untuk gambar dan teks tidak boleh melebihi nilai maksimum yang didukung model. Model hanya mencari satu gambar per pemanggilan, tetapi Anda dapat melakukan beberapa pemanggilan untuk memproses beberapa gambar.
Model yang menentukan jumlah gambar yang akan dicari.