Tag Image In Stream - Tag Image In Stream

リファレンス

サービス:: Azure AI Services

API バージョン:: 3.2

この操作は、指定された画像のコンテンツに関連する単語すなわちタグのリストを生成します。 Computer Vision API は、画像内で検出された物体、生物、景色、または動作に基づくタグを返すことができます。カテゴリとは異なり、タグは階層的分類システムで整理されていませんが、画像のコンテンツに対応しています。タグにあいまいさを回避するためのヒントが含まれたり、タグによってコンテキストが提供されたりすることがあります。たとえば、"ascomycete" (子嚢菌) というタグに "fungus" (菌類) というヒントが付く場合があります。 2 つの入力方法がサポートされています。(1) イメージのアップロードまたは (2) イメージ URL の指定。成功した応答は JSON で返されます。要求が失敗した場合、応答にはエラーコードと、何が問題が発生したかを理解するのに役立つメッセージが含まれます。

POST {Endpoint}/vision/v3.2/tag

省略可能なパラメーターを含む:

POST {Endpoint}/vision/v3.2/tag?overload=stream&language={language}&model-version={model-version}

URI パラメーター

名前	/	必須	型	説明
Endpoint	path	True	string	サポートされている Cognitive Services エンドポイント。
language	query		string	出力生成に必要な言語。このパラメーターが指定されていない場合、既定値は "en" です。サポートされている言語の一覧については、https://aka.ms/cv-languages を参照してください。
model-version	query		string pattern: ^(latest\|\d{4}-\d{2}-\d{2})(-preview)?$	AI モデルのバージョンを指定する省略可能なパラメーター。指定できる値は、"latest"、"2021-04-01"、"2021-05-01" です。既定値は "latest" です。

要求ヘッダー

Media Types: "application/octet-stream", "multipart/form-data"

名前	必須	型	説明
Ocp-Apim-Subscription-Key	True	string

要求本文

Media Types: "application/octet-stream", "multipart/form-data"

名前	型	説明
Image	object (file)	イメージストリーム。

応答

名前	型	説明
200 OK	TagResult	イメージタグオブジェクト。
Other Status Codes	ComputerVisionErrorResponse	エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

例

Successful TagImage request

要求のサンプル

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/tag?overload=stream


"{binary}"

応答のサンプル

状態コード:: 200

{
  "tags": [
    {
      "name": "grass",
      "confidence": 0.9999997615814209
    },
    {
      "name": "outdoor",
      "confidence": 0.9999706745147705
    },
    {
      "name": "sky",
      "confidence": 0.9992897510528564
    },
    {
      "name": "building",
      "confidence": 0.9964632391929626
    },
    {
      "name": "house",
      "confidence": 0.9927980303764343
    },
    {
      "name": "lawn",
      "confidence": 0.8226802945137024
    },
    {
      "name": "green",
      "confidence": 0.6412225365638733
    },
    {
      "name": "residential",
      "confidence": 0.31403225660324097
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 400,
    "height": 400,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

定義

名前	説明
ComputerVisionError	API 要求エラー。
ComputerVisionErrorCodes	エラーコード。
ComputerVisionErrorResponse	API エラー応答。
ComputerVisionInnerError	API 要求エラーの詳細。
ComputerVisionInnerErrorCodeValue	エラーコード。
ImageMetadata	イメージメタデータ。
ImageTag	信頼度スコアと共に、画像内のエンティティの観察。
TagResult	任意のタグと画像メタデータを含む、イメージタグ操作の結果。

ComputerVisionError

Object

API 要求エラー。

名前	型	説明
code	ComputerVisionErrorCodes	エラーコード。
innererror	ComputerVisionInnerError	内部エラーには、より具体的な情報が含まれています。
message	string	サービスによって報告されたエラーを説明するメッセージ。

ComputerVisionErrorCodes

列挙

エラーコード。

値	説明
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

Object

API エラー応答。

名前	型	説明
error	ComputerVisionError	エラーの内容。

ComputerVisionInnerError

Object

API 要求エラーの詳細。

名前	型	説明
code	ComputerVisionInnerErrorCodeValue	エラーコード。
message	string	エラーメッセージ。

ComputerVisionInnerErrorCodeValue

列挙

エラーコード。

値	説明
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

ImageMetadata

Object

イメージメタデータ。

名前	型	説明
format	string	イメージ形式。
height	integer (int32)	画像の高さ (ピクセル単位)。
width	integer (int32)	画像の幅 (ピクセル単位)。

ImageTag

Object

信頼度スコアと共に、画像内のエンティティの観察。

名前	型	説明
confidence	number (double)	エンティティが観察された信頼度。
hint	string	このタグの省略可能なヒント/詳細。
name	string	エンティティの名前。

TagResult

Object

任意のタグと画像メタデータを含む、イメージタグ操作の結果。

名前	型	説明
metadata	ImageMetadata	イメージメタデータ。
modelVersion	string pattern: ^(latest\|\d{4}-\d{2}-\d{2})(-preview)?$	AI モデルのバージョン。
requestId	string	REST API 要求の ID。
tags	ImageTag[]	信頼度レベルを持つタグの一覧。

次の方法で共有

Tag Image In Stream - Tag Image In Stream

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

Ocp-Apim-Subscription-Key

例

Successful TagImage request

要求のサンプル

応答のサンプル

定義

ComputerVisionError

ComputerVisionErrorCodes

ComputerVisionErrorResponse

ComputerVisionInnerError

ComputerVisionInnerErrorCodeValue

ImageMetadata

ImageTag

TagResult