Краткое руководство. Поиск изображений с помощью пакета SDK для поиска изображений Bing для PythonQuickstart: Search for images with the Bing Image Search SDK for Python

Воспользуйтесь сведениями из быстрого начала и выполните первый поиск изображения с помощью пакета SDK Bing для поиска изображений. Данный пакет является оболочкой для API и содержит те же функции.Use this quickstart to make your first image search using the Bing Image Search SDK, which is a wrapper for the API and contains the same features. Это простое приложение Python отправляет запрос на поиск изображения, анализирует ответ JSON и отображает URL-адрес первого возвращенного изображения.This simple Python application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

Исходный код, используемый в данном примере, вместе с дополнительной обработкой ошибок и аннотациями можно получить на GitHub.The source code for this sample is available on GitHub with additional error handling and annotations.

Предварительные требованияPrerequisites

Получите ключ доступа Cognitive Services с помощью поиска.Get a Cognitive Services access key under Search. См. также Цены на Cognitive Services. API-интерфейсы поиска Bing.See also Cognitive Services Pricing - Bing Search API.

Необходимо иметь учетную запись API Cognitive Services с доступом к API-интерфейсам поиска Bing.You must have a Cognitive Services API account with access to the Bing Search APIs. Если у вас нет подписки Azure, создайте бесплатную учетную запись.If you don't have an Azure subscription, you can create an account for free. Перед тем как продолжить, потребуется ключ доступа, предоставляемый после активации бесплатной пробной версии или ключ платной подписки, указанный на панели мониторинга Azure.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Создание и инициализация приложенияCreate and initialize the application

  1. Создайте сценарий Python в избранной интегрированной среде разработки или редакторе и добавьте следующие строки импорта:Create a new Python script in your favorite IDE or editor, and the following imports:

    from azure.cognitiveservices.search.imagesearch import ImageSearchAPI
    from msrest.authentication import CognitiveServicesCredentials
    
  2. Создайте переменные для ключа подписки и условия поиска.Create variables for your subscription key and search term.

    subscription_key = "Enter your key here"
    search_term = "canadian rockies"
    

Создание клиента для поиска изображенийCreate the image search client

  1. Создайте экземпляр CognitiveServicesCredentials и используйте его для создания клиента:Create an instance of CognitiveServicesCredentials, and use it to instantiate the client:

    client = ImageSearchAPI(CognitiveServicesCredentials(subscription_key))
    
  2. Отправьте поисковой запрос к API Bing для поиска изображений:Send a search query to the Bing Image Search API:

    image_results = client.images.search(query=search_term)
    

    Обработка и просмотр результатовProcess and view the results

Выполните синтаксический анализ результатов изображений, возвращенных в ответе.Parse the image results returned in the response.

Если в ответе содержатся результаты поиска, сохраните первый результат и распечатайте такие сведения, как URL-адрес эскиза, исходный URL-адрес и общее количество возвращенных изображений.If the response contains search results, store the first result and print out its details, such as a thumbnail URL, the original URL,along with the total number of returned images.

if image_results.value:
    first_image_result = image_results.value[0]
    print("Total number of images returned: {}".format(len(image_results.value)))
    print("First image thumbnail url: {}".format(
        first_image_result.thumbnail_url))
    print("First image content url: {}".format(first_image_result.content_url))
else:
    print("No image results returned!")

Дополнительная информацияNext steps

См. такжеSee also