Puntos de conexión para Bing Image Search API
Advertencia
El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a los servicios de Bing Search. Esta documentación se proporciona solo como referencia. Para obtener documentación actualizada, consulte la documentación de Bing Search API. Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para Bing Search, consulte el artículo sobre la creación de un recurso de Bing Search a través de Azure Marketplace.
Image Search API incluye tres puntos de conexión. El punto de conexión 1 devuelve imágenes de la web en función de una consulta. El punto de conexión 2 devuelve ImageInsights. El punto de conexión 3 devuelve imágenes populares.
Puntos de conexión
Para obtener resultados de imágenes con Bing API, envíe una solicitud a uno de los siguientes puntos de conexión. Use los encabezados y parámetros de dirección URL para definir especificaciones adicionales.
Punto de conexión 1: devuelve imágenes relacionadas con la consulta de búsqueda del usuario definida por ?q="".
GET https://api.cognitive.microsoft.com/bing/v7.0/images/search
Punto de conexión 2: devuelve información detallada sobre una imagen, ya sea mediante GET o POST.
GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details
Una solicitud GET devuelve información detallada sobre una imagen, como páginas web que incluyen la imagen. Incluya el parámetro insightsToken con una solicitud GET.
O bien, puede incluir una imagen binaria en el cuerpo de una solicitud POST y establecer el parámetro modules en RecognizedEntities. Esto devolverá insightsToken que se utilizará como parámetro en una solicitud GET subsiguiente, que devuelve información sobre las personas de la imagen. Establezca modules en All para obtener todos los detalles, excepto RecognizedEntities en los resultados de POST sin realizar otra llamada mediante insightsToken.
Punto de conexión 3: devuelve imágenes que son populares en función de las solicitudes de búsqueda que realizan otros usuarios. Las imágenes se dividen en categorías diferentes, por ejemplo, en función de personas o eventos destacables.
GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending
Para una lista de los mercados que admiten imágenes populares, consulte Imágenes populares.
Para más información sobre encabezados, parámetros, códigos de mercado, objetos de respuesta, errores etc., consulte la referencia Bing Image Search API v7.
Respuesta JSON
La respuesta a una solicitud de búsqueda de imágenes incluye los resultados como objetos JSON. Para obtener ejemplos de análisis de los resultados, consulte el tutorial y el código fuente.
Pasos siguientes
Las API de Bing admiten acciones de búsqueda que devuelven resultados según su tipo. Todos los puntos de conexión de búsqueda devuelven resultados como objetos de respuesta JSON. Todos los puntos de conexión admiten consultas que devuelven un idioma o una ubicación en concreto por longitud, latitud y radio de búsqueda.
Para una información completa acerca de los parámetros admitidos por cada punto de conexión, consulte las páginas de referencia de cada tipo. Para obtener ejemplos de solicitudes básicas mediante Image Search API, consulte los inicios rápidos de Image Search.