Image Retrieval - Vectorize Image

Служба:

Cognitive Services - Computer Vision

Версия API:

2023-04-01-preview

Возвращает вектор из изображения.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
api-version	query	True	string	Запрошенная версия API.
model-version	query		string	Версия модели.

Текст запроса

Имя	Обязательно	Тип	Описание
url	True	string	Общедоступный URL-адрес изображения.

Ответы

Имя	Тип	Описание
200 OK	SingleVectorResultApiModel	Успех
Other Status Codes	ErrorResponse	Ошибка Заголовки x-ms-error-code: string

Примеры

ImageRetrieval_VectorizeImage

Образец запроса

HTTP

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

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

Пример ответа

Код состояния:

200

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

Определения

Имя	Описание
ErrorResponse	Ответ возвращается при возникновении ошибки.
ErrorResponseDetails	Сведения об ошибке.
ErrorResponseInnerError	Подробная ошибка.
ImageUrl	Документ JSON с URL-адресом, указывающим на анализируемое изображение.
SingleVectorResultApiModel	Результаты векторизации изображений.

ErrorResponse

Ответ возвращается при возникновении ошибки.

Имя	Тип	Описание
error	ErrorResponseDetails	Сведения об ошибке.

ErrorResponseDetails

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
details	ErrorResponseDetails[]	Список подробных ошибок.
innererror	ErrorResponseInnerError	Подробная ошибка.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponseInnerError

Подробная ошибка.

Имя	Тип	Описание
code	string	Код ошибки.
innererror	ErrorResponseInnerError	Подробная ошибка.
message	string	Сообщение об ошибке.

ImageUrl

Документ JSON с URL-адресом, указывающим на анализируемое изображение.

Имя	Тип	Описание
url	string	Общедоступный URL-адрес изображения.

SingleVectorResultApiModel

Результаты векторизации изображений.

Имя	Тип	Описание
modelVersion	string	Версия модели.
vector	number[]	Вектор изображения.