Vectorize - Image

Serviço:

Azure AI Services

Versão da API:

2024-02-01

Vetor de retorno de uma imagem.

POST /retrieval:vectorizeImage?model-version={model-version}&api-version=2024-02-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
api-version	query	True	string	Versão da API solicitada.
model-version	query	True	string	Versão do modelo. Consulte https://aka.ms/image-retrieval para versões de modelo com suporte.

Corpo da solicitação

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

Respostas

Nome	Tipo	Description
200 OK	SingleVectorResult	Êxito
Other Status Codes	ErrorResponse	Erro Cabeçalhos x-ms-error-code: string

Exemplos

VectorizeImage_MaximumSet_Gen

VectorizeImage_MinimumSet_Gen

VectorizeImage_MaximumSet_Gen

Solicitação de exemplo

HTTP

POST /retrieval:vectorizeImage?model-version=smwtkmvew&api-version=2024-02-01

{
  "url": "https://microsoft.com/a"
}

Resposta de exemplo

Código de status:

200

{
  "vector": [
    14
  ],
  "modelVersion": "dpcfdmwpqyrzmkrwdauywmdcoduss"
}

VectorizeImage_MinimumSet_Gen

Solicitação de exemplo

HTTP

POST /retrieval:vectorizeImage?model-version=ghajr&api-version=2024-02-01

{
  "url": "https://microsoft.com/a"
}

Resposta de exemplo

Código de status:

200

{}

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 acessível publicamente a ser analisada.
SingleVectorResult	Resultados da vetorização de imagem.

ErrorResponse

Objeto

Resposta retornada quando ocorre um erro.

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

ErrorResponseDetails

Objeto

Informações de erro.

Nome	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

Objeto

Erro detalhado.

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

ImageUrl

Objeto

Um documento JSON com uma URL apontando para a imagem acessível publicamente a ser analisada.

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

SingleVectorResult

Objeto

Resultados da vetorização de imagem.

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