Endpunkte für die Bing-Bildersuche-API
Warnung
Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.
Die Bildersuche-API umfasst drei Endpunkte. Endpunkt 1 gibt Bilder aus dem Internet basierend auf einer Abfrage zurück. Endpunkt 2 gibt ImageInsights zurück. Endpunkt 3 gibt beliebte Videos zurück.
Endpunkte
Um mithilfe der Bing-API Bildergebnisse zu erhalten, senden Sie eine Anforderung an einen der folgenden Endpunkte. Verwenden Sie die Header und die URL-Parameter, um Spezifikationen genauer zu definieren.
Endpunkt 1: gibt Entitäten Bilder, die für die von ?q="" definierte Suchabfrage des Benutzers relevant sind
GET https://api.cognitive.microsoft.com/bing/v7.0/images/search
Endpunkt 2: gibt entweder mit GET oder POST Einblicke zum Bild zurück.
GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details
Eine GET-Anforderung gibt Einblicke zu einem Bild zurück, z.B. Webseiten, die dieses Bild enthalten. Integrieren Sie den InsightsToken-Parameter in eine GET-Anforderung.
Oder Sie können ein Binärbild in den Text einer POST-Anforderung einfügen und den modules-Parameter auf RecognizedEntities setzen. Dies gibt einen insightsToken-Parameter zurück, der in einer nachfolgenden GET-Anforderung verwendet wird, die Informationen über Personen im Bild zurückgibt. Setzen Sie modules auf All, um alle Einblicke zu erhalten, außer RecognizedEntities in den Ergebnissen von POST, ohne einen weiteren Aufruf mit insightsToken zu machen.
Endpunkt 3: gibt Bilder zurück, die auf der Grundlage von Suchanfragen anderer beliebt sind. Die Bilder sind in verschiedene Kategorien eingeteilt, z.B. nach Personen oder Ereignissen.
GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending
Eine Liste der Märkte, die beliebte Bilder unterstützen, finden Sie unter Beliebte Bilder.
Weitere Informationen zu Headern, Parametern, Marktcodes, Antwortobjekten, Fehlern usw. finden Sie in der Referenz API für die Bing-Bildersuche v7.
JSON-Antwort
Die Antwort auf eine Bildersuchanforderung enthält die Ergebnisse als JSON-Objekten. Beispiele für die Analyse der Ergebnisse finden Sie unter Tutorial und Quellcode.
Nächste Schritte
Die Bing-APIs unterstützen Suchaktionen, die Ergebnisse gemäß ihrem Typ zurückgeben. Alle Suchendpunkte geben Ergebnisse als JSON-Antwortobjekte zurück. Alle Endpunkte unterstützen Abfragen, die eine bestimmte Sprache und/oder einen bestimmten Ort nach Längengrad, Breitengrad und Suchradius zurückgeben.
Die umfassenden Informationen zu den Parametern, die von jedem Endpunkt unterstützt werden, finden Sie auf den Referenzseiten des jeweiligen Typs. Beispiele für grundlegende Anforderung mithilfe der Bildersuche-API finden Sie in den Bildersuche-Schnellstarts.