Image Retrieval - Vectorize Image

Service:

Cognitive Services - Computer Vision

API Version:

2023-04-01-preview

Devuelve un vector de una imagen.

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

With optional parameters:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
api-version	query	True	string	Versión de API solicitada.
model-version	query		string	Versión del modelo.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
url	True	string	Dirección URL accesible públicamente de una imagen.

Respuestas

Nombre	Tipo	Description
200 OK	SingleVectorResultApiModel	Correcto
Other Status Codes	ErrorResponse	Error Headers x-ms-error-code: string

Ejemplos

ImageRetrieval_VectorizeImage

Sample Request

HTTP

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

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

Sample Response

Status code:

200

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

Definiciones

Nombre	Description
ErrorResponse	Respuesta devuelta cuando se produce un error.
ErrorResponseDetails	Información de error.
ErrorResponseInnerError	Error detallado.
ImageUrl	Un documento JSON con una dirección URL que apunta a la imagen que se va a analizar.
SingleVectorResultApiModel	Resultados de la vectorización de imagen.

ErrorResponse

Respuesta devuelta cuando se produce un error.

Nombre	Tipo	Description
error	ErrorResponseDetails	Información de error.

ErrorResponseDetails

Información de error.

Nombre	Tipo	Description
code	string	Código de error.
details	ErrorResponseDetails[]	Lista de errores detallados.
innererror	ErrorResponseInnerError	Error detallado.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponseInnerError

Error detallado.

Nombre	Tipo	Description
code	string	Código de error.
innererror	ErrorResponseInnerError	Error detallado.
message	string	Mensaje de error.

ImageUrl

Un documento JSON con una dirección URL que apunta a la imagen que se va a analizar.

Nombre	Tipo	Description
url	string	Dirección URL accesible públicamente de una imagen.

SingleVectorResultApiModel

Resultados de la vectorización de imagen.

Nombre	Tipo	Description
modelVersion	string	Versión del modelo.
vector	number[]	Vector de la imagen.