Image Retrieval - Vectorize Image

Service:

Cognitive Services - Computer Vision

API Version:

2023-04-01-preview

Retornar vetor de uma imagem.

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 URI

Nome	Em	Obrigatório	Tipo	Description
api-version	query	True	string	Versão da API solicitada.
model-version	query		string	Versão do modelo.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
url	True	string	URL acessível publicamente de uma imagem.

Respostas

Nome	Tipo	Description
200 OK	SingleVectorResultApiModel	Êxito
Other Status Codes	ErrorResponse	Erro Headers x-ms-error-code: string

Exemplos

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"
}

Definições

Nome	Description
ErrorResponse	Resposta retornada quando ocorre um erro.
ErrorResponseDetails	Informações de erro.
ErrorResponseInnerError	Erro detalhado.
ImageUrl	Um documento JSON com uma URL apontando para a imagem que deve ser analisada.
SingleVectorResultApiModel	Resultados da vetorização de imagem.

ErrorResponse

Resposta retornada quando ocorre um erro.

Nome	Tipo	Description
error	ErrorResponseDetails	Informações de erro.

ErrorResponseDetails

Informações de erro.

Nome	Tipo	Description
code	string	Código do erro.
details	ErrorResponseDetails[]	Lista de erros detalhados.
innererror	ErrorResponseInnerError	Erro detalhado.
message	string	Mensagem de erro.
target	string	Destino do erro.

ErrorResponseInnerError

Erro detalhado.

Nome	Tipo	Description
code	string	Código do erro.
innererror	ErrorResponseInnerError	Erro detalhado.
message	string	Mensagem de erro.

ImageUrl

Um documento JSON com uma URL apontando para a imagem que deve ser analisada.

Nome	Tipo	Description
url	string	URL acessível publicamente de uma imagem.

SingleVectorResultApiModel

Resultados da vetorização de imagem.

Nome	Tipo	Description
modelVersion	string	Versão do modelo.
vector	number[]	Vetor da imagem.