Generate Thumbnail - Generate Thumbnail

Dienst:

Azure AI Services

API-Version:

3.2

Dieser Vorgang generiert ein Miniaturbild mit der vom Benutzer angegebenen Breite und Höhe. Standardmäßig analysiert der Dienst das Bild, identifiziert die Interessenregion (ROI) und generiert intelligente Zuschneidekoordinaten basierend auf dem ROI. Intelligentes Zuschneiden hilft, wenn Sie ein Seitenverhältnis angeben, das sich von dem des Eingabebilds unterscheidet. Eine erfolgreiche Antwort enthält die Binärdatei des Miniaturbilds. Wenn die Anforderung fehlgeschlagen ist, enthält die Antwort einen Fehlercode und eine Meldung, um zu ermitteln, was schief gelaufen ist. Bei Einem Fehler werden der Fehlercode und eine Fehlermeldung zurückgegeben. Der Fehlercode kann einer von InvalidImageUrl, InvalidImageFormat, InvalidImageSize, InvalidThumbnailSize, NotSupportedImage, FailedToProcess, Timeout oder InternalServerError sein.

POST {Endpoint}/vision/v3.2/generateThumbnail?width={width}&height={height}

Mit optionalen Parametern:

POST {Endpoint}/vision/v3.2/generateThumbnail?width={width}&height={height}&smartCropping={smartCropping}&model-version={model-version}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte.
height	query	True	integer (int32) minimum: 1 maximum: 1024	Höhe der Miniaturansicht in Pixel. Es muss zwischen 1 und 1024 sein. Empfohlener Mindestwert von 50.
width	query	True	integer (int32) minimum: 1 maximum: 1024	Breite der Miniaturansicht in Pixel. Es muss zwischen 1 und 1024 sein. Empfohlener Mindestwert von 50.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Optionaler Parameter zum Angeben der Version des KI-Modells. Akzeptierte Werte sind: "latest", "2021-04-01", "2021-05-01". Der Standardwert ist "latest".
smartCropping	query		boolean	Boolesche Kennzeichnung zum Aktivieren des intelligenten Zuschneidens.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
url	True	string	Öffentlich erreichbare URL eines Bilds.

Antworten

Name	Typ	Beschreibung
200 OK	file	Die generierte Miniaturansicht im Binärformat. Media Types: "application/octet-stream"
Other Status Codes	ComputerVisionErrorResponse	Fehlerantwort. Media Types: "application/octet-stream"

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful GenerateThumbnail request

Beispielanforderung

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/generateThumbnail?width=500&height=500&smartCropping=True


{
  "url": "{url}"
}

Beispiel für eine Antwort

Statuscode:

200

"{Binary}"

Definitionen

Name	Beschreibung
ComputerVisionError	Der API-Anforderungsfehler.
ComputerVisionErrorCodes	Der Fehlercode.
ComputerVisionErrorResponse	Die API-Fehlerantwort.
ComputerVisionInnerError	Details zum API-Anforderungsfehler.
ComputerVisionInnerErrorCodeValue	Der Fehlercode.
ImageUrl

ComputerVisionError

Objekt

Der API-Anforderungsfehler.

Name	Typ	Beschreibung
code	ComputerVisionErrorCodes	Der Fehlercode.
innererror	ComputerVisionInnerError	Innerer Fehler enthält spezifischere Informationen.
message	string	Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt.

ComputerVisionErrorCodes

Enumeration

Der Fehlercode.

Wert	Beschreibung
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

Objekt

Die API-Fehlerantwort.

Name	Typ	Beschreibung
error	ComputerVisionError	Fehlerinhalte.

ComputerVisionInnerError

Objekt

Details zum API-Anforderungsfehler.

Name	Typ	Beschreibung
code	ComputerVisionInnerErrorCodeValue	Der Fehlercode.
message	string	Fehlermeldung.

ComputerVisionInnerErrorCodeValue

Enumeration

Der Fehlercode.

Wert	Beschreibung
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

ImageUrl

Objekt

Name	Typ	Beschreibung
url	string	Öffentlich erreichbare URL eines Bilds.