Hämta bilder från webben med API för bildsökning i Bing

  • Artikel

Varning

Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

När du använder REST-API:et för bildsökning i Bing kan du hämta bilder från webben som är relaterade till söktermen genom att skicka följande GET-begäran:

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Använd frågeparametern q för den URL-kodade söktermen. Om du till exempel anger seglings jollar anger du q till sailing+dinghies eller sailing%20dinghies.

Viktigt

  • Alla begäranden måste göras från en server och inte från en klient.
  • Om det är första gången du anropar något av API:erna för Bing-sökning ska du inte ta med klient-ID-huvudet. Inkludera endast klient-ID:t om du tidigare har anropat ett Bing-API som returnerade ett klient-ID för kombinationen användare och enhet.

Hämta avbildningar från en specifik webbdomän

Om du vill hämta bilder från en specifik domän använder du frågeoperatorn site:.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Anteckning

Svar på frågor som använder operatorn kan innehålla vuxet site: innehåll oavsett inställningen safeSearch . Använd site: endast om du känner till innehållet på domänen.

Filtrera bilder

Som standard returnerar API:et för bildsökning alla bilder som är relevanta för frågan. Om du vill filtrera de bilder som Bing returnerar (till exempel för att endast returnera bilder med transparent bakgrund eller specifik storlek) använder du följande frågeparametrar:

  • aspect – Filtrera bilder efter bredd–höjd-förhållande (till exempel standardbilder eller bredskärmsbilder).
  • color – Filtrera bilder efter dominerande färg eller svartvitt.
  • färskhet – Filtrera bilder efter ålder (till exempel bilder som identifierats av Bing under den senaste veckan).
  • height, width – Filtrera bilder efter bredd och höjd.
  • imageContent – Filtrera bilder efter innehåll (till exempel bilder som bara visar en persons ansikte).
  • imageType – Filtrera bilder efter typ (till exempel ClipArt, animerade GIF-filer eller transparenta bakgrunder).
  • license – Filtrera bilder efter den typ av licens som är associerad med webbplatsen.
  • size – Filtrera bilder efter storlek, till exempel små bilder upp till 200 x 200 bildpunkter.

Om du vill hämta bilder från en specifik domän använder du frågeoperatorn site:.

I följande exempel visas hur du hämtar små bilder från ContosoSailing.com som Bing har identifierat under den senaste veckan.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Svarsformat för bildsökning i Bing

Svarsmeddelandet från Bing innehåller ett avbildningssvar som innehåller en lista över avbildningar som Azure AI-tjänster har fastställt vara relevanta för frågan. Varje bildobjekt i listan innehåller följande information om bilden: URL:en, dess storlek, dess dimensioner, dess kodningsformat, en URL till en miniatyrbild av bilden och miniatyrbildens dimensioner.

Anteckning

  • Bilder måste visas i den ordning som anges i svaret.
  • Eftersom URL-format och parametrar kan ändras utan föregående meddelande använder du alla URL:er i nuläget. Du bör inte använda beroenden för URL-format eller parametrar förutom där det anges.
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

När du anropar API för bildsökning i Bing returnerar Bing en lista med resultat. Listan är en delmängd av det totala antalet resultat som är relevanta för frågan. Svarets fält totalEstimatedMatches innehåller en uppskattning av det antal bilder som är tillgängliga för visning. Mer information om hur du bläddrar igenom resten av bilderna finns i Sidindelningsbilder.

Nästa steg

Om du inte har provat API:et för bildsökning i Bing tidigare kan du prova en snabbstart. Om du letar efter något mer komplext kan du prova självstudien för att skapa en enkelsidig webbapp.