Titik akhir untuk API Pencarian Gambar Bing

  • Artikel

Peringatan

Pada 30 Oktober 2020, API Bing Search dipindahkan dari layanan Azure AI ke layanan Bing Search. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Pencarian Bing melalui Marketplace Azure.

API Pencarian Gambar mencakup tiga titik akhir. Titik akhir 1 menampilkan gambar dari Web berdasarkan kueri. Titik akhir 2 menampilkan ImageInsights. Titik akhir 3 menampilkan gambar yang sedang tren.

Titik akhir

Untuk mendapatkan hasil gambar menggunakan API Bing, kirim permintaan ke salah satu titik akhir berikut. Gunakan header dan parameter URL untuk menentukan spesifikasi lebih lanjut.

Titik akhir1: Menampilkan gambar yang relevan dengan kueri pencarian pengguna yang ditentukan oleh ?q="".

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search

Titik akhir2: Menampilkan wawasan tentang gambar, baik menggunakan GET atau POST.

 GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details

Permintaan GET menampilkan wawasan tentang gambar, seperti Halaman web yang menyertakan gambar. Sertakan parameter insightsToken dengan permintaan GET.

Atau, Anda dapat menyertakan gambar biner di isi permintaan POST dan mengatur parameter modul ke RecognizedEntities. Hal ini akan menghasilkan insightsToken untuk digunakan sebagai parameter dalam permintaan GET berikutnya, yang menampilkan informasi tentang orang-orang dalam gambar. Atur modules ​​ke All untuk mendapatkan semua wawasan, kecuali RecognizedEntities di hasil POST tanpa melakukan panggilan lain menggunakan insightsToken.

Titik akhir3: Menampilkan gambar yang sedang tren berdasarkan permintaan pencarian yang dibuat oleh orang lain. Gambar dipisahkan ke dalam kategori yang berbeda, misalnya, berdasarkan orang atau peristiwa penting.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending

Untuk daftar pasar yang mendukung gambar tren, lihat Gambar Tren.

Untuk detail tentang header, parameter, kode pasar, objek respons, kesalahan, dll., lihat referensi API Pencarian Gambar Bing v7.

Respons JSON

Respons terhadap permintaan pencarian gambar menyertakan hasil sebagai objek JSON. Untuk contoh penguraian hasil, lihat tutorial dan kode sumber.

Langkah berikutnya

API Bing mendukung tindakan pencarian yang menampilkan hasil menurut jenisnya. Semua titik akhir pencarian menampilkan hasil sebagai objek respons JSON.  Semua titik akhir mendukung kueri yang menampilkan bahasa dan/atau lokasi tertentu menurut garis bujur, garis lintang, dan radius pencarian.

Untuk informasi selengkapnya tentang parameter yang didukung oleh setiap titik akhir, lihat halaman referensi untuk setiap jenis. Untuk contoh permintaan dasar menggunakan API Pencarian Gambar, lihat Memulai Cepat Penelusuran Gambar.