Image Retrieval - Vectorize Image

Servicio:

Cognitive Services - Computer Vision

Versión de la API:

2023-04-01-preview

Devuelve un vector de una imagen.

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

Con parámetros opcionales:

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 Encabezados x-ms-error-code: string

Ejemplos

ImageRetrieval_VectorizeImage

Solicitud de ejemplo

HTTP

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

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

Respuesta de muestra

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.