Partilhar via


Pontos finais para a API de Pesquisa de Imagens do Bing

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

A API de Pesquisa de Imagens inclui três pontos finais. O ponto final 1 devolve imagens da Web com base numa consulta. O ponto final 2 devolve ImageInsights. O ponto final 3 devolve imagens populares.

Pontos Finais

Para obter resultados de imagens com a API do Bing, envie um pedido para um dos seguintes pontos finais. Utilize os cabeçalhos e os parâmetros de URL para definir mais especificações.

Ponto final 1: Devolve imagens relevantes para a consulta de pesquisa do utilizador definida por ?q="".

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

Ponto final 2: Devolve informações sobre uma imagem, utilizando ou GETPOST.

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

Um pedido GET devolve informações sobre uma imagem, como páginas Web que incluem a imagem. Inclua o parâmetro insightsToken com um GET pedido.

Em alternativa, pode incluir uma imagem binária no corpo de um POST pedido e definir o parâmetro modules como RecognizedEntities. Isto devolverá um insightsToken para utilizar como parâmetro num pedido subsequente GET , que devolve informações sobre pessoas na imagem. Defina modules como para obter todas as informações, exceto RecognizedEntities nos resultados do POST sem efetuar outra chamada com o insightsTokenAll .

Ponto final 3: Devolve imagens que estão em tendência com base nos pedidos de pesquisa feitos por outras pessoas. As imagens são separadas em diferentes categorias, por exemplo, com base em pessoas ou eventos notáveis.

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

Para obter uma lista de mercados que suportam imagens populares, consulte Imagens Populares.

Para obter detalhes sobre cabeçalhos, parâmetros, códigos de mercado, objetos de resposta, erros, etc., veja a referência da API de Pesquisa de Imagens do Bing v7 .

JSON de Resposta

A resposta a um pedido de pesquisa de imagens inclui resultados como objetos JSON. Para obter exemplos de análise dos resultados, veja o tutorial e o código fonte.

Passos seguintes

As APIs do Bing suportam ações de pesquisa que devolvem resultados de acordo com o respetivo tipo. Todos os pontos finais de pesquisa devolvem resultados como objetos de resposta JSON.  Todos os pontos finais suportam consultas que devolvem um idioma e/ou localização específicos por longitude, latitude e raio de pesquisa.

Para obter informações completas sobre os parâmetros suportados por cada ponto final, consulte as páginas de referência para cada tipo. Para obter exemplos de pedidos básicos com a API de pesquisa de imagens, veja Inícios Rápidos da Pesquisa de Imagens.