Image Retrieval - Vectorize Image

Serviço:

Cognitive Services - Computer Vision

Versão da API:

2023-04-01-preview

Devolver vetor de uma imagem.

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

Com parâmetros opcionais:

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
api-version	query	True	string	Versão da API pedida.
model-version	query		string	Versão do modelo.

Corpo do Pedido

Name	Necessário	Tipo	Description
url	True	string	URL acessível publicamente de uma imagem.

Respostas

Name	Tipo	Description
200 OK	SingleVectorResultApiModel	Success
Other Status Codes	ErrorResponse	Erro Cabeçalhos x-ms-error-code: string

Exemplos

ImageRetrieval_VectorizeImage

Pedido de amostra

HTTP

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

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

Resposta da amostra

Código de estado:

200

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

Definições

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

ErrorResponse

Resposta devolvida quando ocorre um erro.

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

ErrorResponseDetails

Informações de erro.

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

ErrorResponseInnerError

Erro detalhado.

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

ImageUrl

Um documento JSON com um URL a apontar para a imagem que deve ser analisada.

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

SingleVectorResultApiModel

Resultados da vetorização de imagens.

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