Vectorize - Image

サービス:

Azure AI Services

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 (uri)	イメージのパブリックに到達可能な 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	分析対象のパブリックにアクセス可能なイメージを指す URL を含む JSON ドキュメント。
SingleVectorResult	画像ベクター化の結果。

ErrorResponse

Object

エラーが発生したときに返される応答。

名前	型	説明
error	ErrorResponseDetails	エラー情報。

ErrorResponseDetails

Object

エラー情報。

名前	型	説明
code	string	エラー コード。
details	ErrorResponseDetails[]	詳細なエラーの一覧。
innererror	ErrorResponseInnerError	詳細なエラー。
message	string	エラーメッセージ。
target	string	エラーのターゲット。

ErrorResponseInnerError

Object

詳細なエラー。

名前	型	説明
code	string	エラー コード。
innererror	ErrorResponseInnerError	詳細なエラー。
message	string	エラーメッセージ。

ImageUrl

Object

分析対象のパブリックにアクセス可能なイメージを指す URL を含む JSON ドキュメント。

名前	型	説明
url	string (uri)	イメージのパブリックに到達可能な URL。

SingleVectorResult

Object

画像ベクター化の結果。

名前	型	説明
modelVersion	string	モデルのバージョン。
vector	number[] (float)	画像のベクター。