Vectorize - Image

Служба:

Cognitive Services - Computer Vision

Версия API:

2024-02-01

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

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
api-version	query	True	string	Запрошенная версия API.
model-version	query	True	string	Версия модели. Поддерживаемые версии моделей см. в этой статье https://aka.ms/image-retrieval .

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

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

Ответы

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

Примеры

VectorizeImage_MaximumSet_Gen

VectorizeImage_MinimumSet_Gen

VectorizeImage_MaximumSet_Gen

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

HTTP

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

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

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

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

200

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

VectorizeImage_MinimumSet_Gen

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

HTTP

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

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

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

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

200

{}

Определения

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

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-адрес изображения.

SingleVectorResult

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

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