Abrufen von Bildern aus dem Web mit der Bing-Bildersuche-APIGet images from the web with the Bing Image Search API

Wenn Sie mit der Bing-Bildersuche-REST-API Bilder aus dem Web abrufen, erhalten Sie Bilder, die sich auf Ihren Suchbegriff beziehen, indem Sie die folgende GET-Anforderung senden:When you use the Bing Image Search REST API, you can get images from the web that are related to your search term by sending the following GET request:

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

Verwenden Sie den Abfrageparameter q für Ihren URL-codierten Suchbegriff.Use the q query parameter for your url-encoded search term. Wenn Sie z. B. sailing dinghies eingeben, legen Sie q auf sailing+dinghies oder sailing%20dinghies fest.For example, if you enter sailing dinghies, set q to sailing+dinghies or sailing%20dinghies.

Wichtig

  • Alle Anforderungen müssen über einen Server erfolgen, nicht über einen Client.All requests must be made from a server, and not from a client.
  • Lassen Sie den Client-ID-Header weg, falls Sie zuvor noch keine APIs für die Bing-Suche aufgerufen haben.If it's your first time calling any of the Bing search APIs, don't include the client ID header. Binden Sie die Client-ID nur ein, wenn Sie bereits eine Bing-API aufgerufen haben, mit der eine Client-ID für die Kombination aus Benutzer und Gerät zurückgegeben wurde.Only include the client ID if you've previously called a Bing API that returned a client ID for the user and device combination.

Abrufen von Bildern aus einer bestimmten WebdomäneGet images from a specific web domain

Wenn Sie Bilder aus einer bestimmten Domäne abrufen möchten, verwenden Sie den Abfrageoperator site:.To get images from a specific domain, use the site: query operator.

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

Hinweis

Antworten auf Abfragen, für die der Operator site: verwendet wird, können unter Umständen nicht jugendfreien Inhalt enthalten, und zwar unabhängig von der Einstellung safeSearch.Responses to queries using the site: operator might include adult content regardless of the safeSearch setting. Verwenden Sie site: nur, wenn Sie den Inhalt der Domäne kennen.Only use site: if you're aware of the content on the domain.

Filtern von BildernFilter images

Die Bildersuche-API gibt standardmäßig alle Bilder zurück, die für die Abfrage relevant sind.By default, the Image Search API returns all images that are relevant to the query. Wenn Sie die von Bing zurückgegebenen Bilder filtern möchten (um z. B. nur Bilder mit einem durchsichtigen Hintergrund oder einer bestimmten Größe zurückzugeben), verwenden Sie die folgenden Abfrageparameter:If you want to filter the images that Bing returns (for example, to return only images with a transparent background or specific size), use the following query parameters:

  • aspect: Filtert Bilder nach Seitenverhältnis (beispielsweise Standard oder Breitbild).aspect—Filter images by aspect ratio (for example, standard or wide screen images).
  • color: Filtert Bilder nach dominanter Farbe oder Schwarzweiß.color—Filter images by dominant color or black and white.
  • freshness: Filtert Bilder nach Alter (beispielsweise Bilder, die von Bing in der letzten Woche gefunden wurden).freshness—Filter images by age (for example, images discovered by Bing in the past week).
  • height, width: Filtert Bilder nach Breite und Höhe.height, width—Filter images by width and height.
  • imageContent: Filtert Bilder nach Inhalt (beispielsweise Bilder, die nur das Gesicht einer Person zeigen).imageContent—Filter images by content (for example, images that show only a person's face).
  • imageType: Filtert Bilder nach Typ (beispielsweise ClipArts, animierte GIFs oder transparente Hintergründe).imageType—Filter images by type (for example, clip art, animated GIFs, or transparent backgrounds).
  • license: Filtert Bilder nach Art der Websitelizenz.license—Filter images by the type of license associated with the site.
  • size: Filtert Bilder nach Größe (beispielsweise kleine Bilder bis zu einer Größe von 200 x 200 Pixel).size—Filter images by size, such as small images up to 200x200 pixels.

Wenn Sie Bilder aus einer bestimmten Domäne abrufen möchten, verwenden Sie den Abfrageoperator site:.To get images from a specific domain, use the site: query operator.

Das folgende Beispiel zeigt, wie Sie von ContosoSailing.com kleine Bilder abrufen, die Bing in der letzten Woche gefunden hat.The following example shows how to get small images from ContosoSailing.com that Bing discovered in the past week.

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  

Format von Antworten der Bing-BildersucheBing Image Search response format

Die Antwortnachricht von Bing enthält eine Images-Antwort mit einer Liste mit Bildern, die von Cognitive Services als für die Abfrage relevant ermittelt wurden.The response message from Bing contains an Images answer that contains a list of images that Cognitive Services determined to be relevant to the query. Jedes Image-Objekt der Liste enthält die folgenden Informationen zum Bild: URL, Größe, Abmessungen, Codierungsformat, URL für eine Miniaturansicht des Bilds und die Abmessungen der Miniaturansicht.Each Image object in the list includes the following information about the image: the URL, its size, its dimensions, its encoding format, a URL to a thumbnail of the image, and the thumbnail's dimensions.

Hinweis

  • Bilder müssen in der Reihenfolge angezeigt werden, die von der Antwort vorgegeben wird.Images must be displayed in the order provided in the response.
  • Da sich URL-Formate und -Parameter ohne Vorankündigung ändern können, sollten Sie alle URLs in der vorliegenden Form verwenden.Because URL formats and parameters are subject to change without notice, use all URLs as-is. Es sollten keine Abhängigkeiten von URL-Formaten oder -Parametern bestehen, außer wenn dies angegeben ist.You should not take dependencies on the URL format or parameters except where noted.
{
    "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"
},

Wenn Sie die Bing-Bildersuche-API aufrufen, gibt Bing eine Liste mit Ergebnissen zurück.When you call the Bing Image Search API, Bing returns a list of results. Bei der Liste handelt es sich um eine Teilmenge der gesamten Ergebnisse, die für die Abfrage relevant sind.The list is a subset of the total number of results that are relevant to the query. Das Feld totalEstimatedMatches der Antwort enthält die geschätzte Anzahl von Bildern, die angezeigt werden können.The response's totalEstimatedMatches field contains an estimate of the number of images that are available to view. Ausführliche Informationen zum Blättern durch die restlichen Bilder finden Sie hier.For details about how to page through the rest of the images, see Paging Images.

Nächste SchritteNext steps

Verwenden Sie die Schnellstartanleitung, falls Sie die Bing-Bildersuche-API noch nicht ausprobiert haben.If you haven't tried the Bing Image Search API before, try a quickstart. Falls Sie nach einem komplexeren Ansatz suchen, können Sie das Tutorial zur Erstellung einer Einzelseiten-Web-App ausprobieren.If you're looking for something more complex, try the tutorial to create a single-page web app.