Конечные точки для API Bing для поиска изображений
Предупреждение
30 октября 2020 г. API-интерфейсы Поиск Bing перемещены из служб ИИ Azure в службы Поиск Bing. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.
API поиска изображений включает три конечные точки. Конечная точка 1 возвращает изображения из Интернета на основе запроса. Конечная точка 2 возвращает ImageInsights (аналитические сведения об изображениях). Конечная точка 3 возвращает популярные видео.
Конечные точки
Чтобы получить результаты поиска изображений с помощью API Bing, отправьте запрос на одну из конечных точек, приведенных ниже. Для определения дополнительных спецификаций используйте заголовки и параметры URL-адреса.
Конечная точка 1 возвращает результаты поиска изображений, соответствующие поисковому запросу пользователя, который определен с помощью ?q="".
GET https://api.cognitive.microsoft.com/bing/v7.0/images/search
Конечная точка 2 возвращает аналитические сведения об изображении, используя GET или POST.
GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details
Запрос GET возвращает аналитические сведения об изображении, например веб-страницы, содержащие данное изображение. Включите в запрос GET параметр insightsToken.
Вы также можете включить в текст запроса POST двоичный файл изображения и задать для параметра modules значение RecognizedEntities. При этом будет возвращено значение insightsToken, используемое в качестве параметра в следующем запросе GET, который возвращает сведения о людях на данном изображении. Задайте для параметра modules значение All, чтобы получить в результатах POST все аналитические сведения, кроме RecognizedEntities. При этом не потребуется выполнять второй вызов, используя параметр insightsToken.
Конечная точка 3 возвращает изображения, которые набирают популярность. За основу берутся результаты поисковых запросов, выполненных другими пользователями. Изображения разделяются на различные категории, например, если в них фигурируют примечательные люди или события.
GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending
Список рынков, для которых поддерживается поиск популярных изображений, см. в статье Получение изображений, набирающих популярность.
Дополнительные сведения о заголовках, параметрах, кодах рынков, объектах ответов, ошибках и т. п. вы найдете в справочнике по API Bing для поиска изображений версии 7.
Ответ в формате JSON
Ответ на запрос на поиск изображений содержит результаты в виде объектов JSON. Примеры синтаксического анализа результатов см. в этом руководстве и исходном коде.
Дальнейшие действия
Интерфейсы API Bing поддерживают действия поиска, которые возвращают результаты определенного типа. Все конечные точки поиска возвращают результаты в виде объектов ответа JSON. Все конечные точки поддерживают запросы, которые возвращают результаты с учетом языка и (или) местоположения по значениям долготы, широты и радиуса поиска.
Полные сведения о параметрах, поддерживаемых каждой конечной точкой, приведены в справочной документации по каждому типу. Простые примеры запросов к API для поиска изображений см. в кратких руководствах по поиску изображений.