你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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	Success
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[]	图像的向量。