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

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