Image Retrieval - Vectorize Image

Dienst:

Cognitive Services - Computer Vision

API-Version:

2023-04-01-preview

Gibt einen Vektor aus einem Bild zurück.

POST /retrieval:vectorizeImage?api-version=2023-04-01-preview

Mit optionalen Parametern:

POST /retrieval:vectorizeImage?model-version={model-version}&api-version=2023-04-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string	Api-Version angefordert.
model-version	query		string	Modellversion.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
url	True	string	Öffentlich zugängliche URL eines Bilds.

Antworten

Name	Typ	Beschreibung
200 OK	SingleVectorResultApiModel	Erfolg
Other Status Codes	ErrorResponse	Fehler Header x-ms-error-code: string

Beispiele

ImageRetrieval_VectorizeImage

Beispielanforderung

HTTP

POST /retrieval:vectorizeImage?model-version=2023-04-01-preview&api-version=2023-04-01-preview

{
  "url": "https://example.com/image.jpg"
}

Beispiel für eine Antwort

Statuscode:

200

{
  "vector": [
    0,
    1.1,
    2.2
  ],
  "modelVersion": "2023-04-01-preview"
}

Definitionen

Name	Beschreibung
ErrorResponse	Antwort, die zurückgegeben wird, wenn ein Fehler auftritt.
ErrorResponseDetails	Fehlerinformationen.
ErrorResponseInnerError	Detaillierter Fehler.
ImageUrl	Ein JSON-Dokument mit einer URL, die auf das zu analysierende Bild verweist.
SingleVectorResultApiModel	Ergebnisse der Bildvektorisierung.

ErrorResponse

Antwort, die zurückgegeben wird, wenn ein Fehler auftritt.

Name	Typ	Beschreibung
error	ErrorResponseDetails	Fehlerinformationen.

ErrorResponseDetails

Fehlerinformationen.

Name	Typ	Beschreibung
code	string	Fehlercode
details	ErrorResponseDetails[]	Liste der detaillierten Fehler.
innererror	ErrorResponseInnerError	Detaillierter Fehler.
message	string	Fehlermeldung.
target	string	Ziel des Fehlers.

ErrorResponseInnerError

Detaillierter Fehler.

Name	Typ	Beschreibung
code	string	Fehlercode
innererror	ErrorResponseInnerError	Detaillierter Fehler.
message	string	Fehlermeldung.

ImageUrl

Ein JSON-Dokument mit einer URL, die auf das zu analysierende Bild verweist.

Name	Typ	Beschreibung
url	string	Öffentlich zugängliche URL eines Bilds.

SingleVectorResultApiModel

Ergebnisse der Bildvektorisierung.

Name	Typ	Beschreibung
modelVersion	string	Modellversion.
vector	number[]	Vektor des Bilds.