Analyze - Image Stream

リファレンス

サービス:: Azure AI Services

API バージョン:: 2024-02-01

入力イメージを分析します。要求には、任意のコンテンツタイプ ['image/*'、'application/octet-stream'] を含むイメージストリームが含まれています。

POST /imageanalysis:analyze?overload=stream&api-version=2024-02-01

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

POST /imageanalysis:analyze?overload=stream&features={features}&language={language}&smartcrops-aspect-ratios={smartcrops-aspect-ratios}&gender-neutral-caption={gender-neutral-caption}&api-version=2024-02-01

URI パラメーター

名前	/	必須	型	説明
api-version	query	True	string	要求された API バージョン。
features	query		VisualFeature[]	要求されたビジュアル機能。少なくとも 1 つのビジュアル機能を指定する必要があります。
gender-neutral-caption	query		boolean	キャプション機能と denseCaptions 機能に対して性別に依存しないキャプションを有効にするブール型 (Boolean) フラグ。このパラメーターを指定しない場合、既定値は "false" になります。
language	query		string	出力生成に必要な言語。このプロパティが指定されていない場合の既定値は "en" です。サポートされている言語の一覧については、「」を参照してください https://aka.ms/cv-languages 。
smartcrops-aspect-ratios	query		array[]	smartCrops 機能に使用する縦横比の一覧。縦横比は、ターゲットのトリミング幅を高さで割ることによって計算されます。サポートされている値は 0.75 ~ 1.8 (含む) です。複数の値をコンマ区切りにする必要があります。このパラメーターが指定されていない場合、サービスは縦横比が 0.5 ~ 2.0 (含む) のトリミング候補を 1 つ返します。

要求本文

Media Types: "application/octet-stream", "image/jpeg", "image/gif", "image/tiff", "image/bmp", "image/png"

名前	型	説明
body	string	イメージストリーム。

応答

名前	型	説明
200 OK	ImageAnalysisResult	Success
Other Status Codes	ErrorResponse	エラーヘッダー x-ms-error-code: string

名前

型

説明

200 OK

ImageAnalysisResult

Success

Other Status Codes

ErrorResponse

エラー

ヘッダー

x-ms-error-code: string

例

ImageAnalysis_Analyze_MaximumSet_Gen

ImageAnalysis_Analyze_MinimumSet_Gen

ImageAnalysis_Analyze_MaximumSet_Gen

要求のサンプル

HTTP

POST /imageanalysis:analyze?overload=stream&features=tags&language=zizuomdsxccdx&smartcrops-aspect-ratios=vqkmzmvchiwlxdaikxqrsbrpvyq&gender-neutral-caption=True&api-version=2024-02-01

"Ynl0ZXM="

応答のサンプル

状態コード:: 200

{
  "captionResult": {
    "text": "wjtogwbozwgawzxikwsvs",
    "confidence": 0
  },
  "objectsResult": {
    "values": [
      {
        "id": "bcvupjoxcviiz",
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        },
        "tags": [
          {
            "name": "ikiqzvbmyrbuskhpphgjjuzvl",
            "confidence": 0
          }
        ]
      }
    ]
  },
  "readResult": {
    "blocks": [
      {
        "lines": [
          {
            "text": "ufmjctoebx",
            "boundingPolygon": [
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              }
            ],
            "words": [
              {
                "text": "cpcsgoi",
                "boundingPolygon": [
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  }
                ],
                "confidence": 0
              }
            ]
          }
        ]
      }
    ]
  },
  "denseCaptionsResult": {
    "values": [
      {
        "text": "hgvxqwxwqgtjfippp",
        "confidence": 0,
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        }
      }
    ]
  },
  "modelVersion": "lymqyonwrxckwzrsxjihbceclts",
  "metadata": {
    "width": 28,
    "height": 7
  },
  "tagsResult": {
    "values": [
      {
        "name": "ikiqzvbmyrbuskhpphgjjuzvl",
        "confidence": 0
      }
    ]
  },
  "smartCropsResult": {
    "values": [
      {
        "aspectRatio": 7,
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        }
      }
    ]
  },
  "peopleResult": {
    "values": [
      {
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        },
        "confidence": 0
      }
    ]
  }
}

ImageAnalysis_Analyze_MinimumSet_Gen

要求のサンプル

HTTP

POST /imageanalysis:analyze?overload=stream&api-version=2024-02-01

"Ynl0ZXM="

応答のサンプル

状態コード:: 200

{
  "modelVersion": "lymqyonwrxckwzrsxjihbceclts",
  "metadata": {
    "width": 28,
    "height": 7
  }
}

定義

名前	説明
BoundingBox	画像内の領域の境界ボックス。
CaptionResult	画像が示す内容の簡単な説明。
ContentTag	信頼度スコアと共に、画像内のエンティティの観察。
CropRegion	スマートトリミング用に識別されるリージョン。要求された縦横比ごとに 1 つのリージョンが返されます。
DenseCaption	画像が示す内容の簡単な説明。
DenseCaptionsResult	キャプションの一覧。
DetectedObject	画像内で検出されたオブジェクトについての説明。
DetectedPerson	画像内で検出された人物。
DetectedTextBlock	検出されたテキストブロック。
DetectedTextLine	検出されたテキスト行。
DetectedTextWord	連続する文字シーケンスで構成される単語が検出されました。中国語、日本語、韓国語などのスペースで区切られた言語以外の言語の場合、各文字は独自の単語として表されます。
ErrorResponse	エラーが発生したときに返される応答。
ErrorResponseDetails	エラー情報。
ErrorResponseInnerError	詳細なエラー。
ImageAnalysisResult	さまざまな種類の画像分析の組み合わせ結果について説明します。
ImageMetadata	高さと幅などの画像メタデータ情報。
ImagePoint	イメージ内のポイントを表すオブジェクト。
ObjectsResult	画像内で検出されたオブジェクトについて説明します。
PeopleResult	イメージに人物が含まれているかどうかを示すオブジェクト。
ReadResult	読み取り操作の結果。
SmartCropsResult	スマートトリミングの結果。
TagsResult	信頼度レベルを持つタグの一覧。
VisualFeature	要求されたビジュアル機能。少なくとも 1 つのビジュアル機能を指定する必要があります。

BoundingBox

画像内の領域の境界ボックス。

名前	型	説明
h	integer	領域の左上の点から計測された高さ (ピクセル単位)。
w	integer	領域の左上の点から計測された幅 (ピクセル単位)。
x	integer	領域の左上の点の左座標 (ピクセル単位)。
y	integer	領域の左上の点の上座標 (ピクセル単位)。

CaptionResult

画像が示す内容の簡単な説明。

名前	型	説明
confidence	number	キャプションにサービスが持つ信頼度。信頼度スコアは 0.0 から 1.0 (両端を含む) の範囲にまたがり、値が大きいほど一致の信頼度が高いことを示します。
text	string	キャプションのテキスト。

ContentTag

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

名前	型	説明
confidence	number	エンティティが観察された信頼度。信頼度スコアは 0.0 から 1.0 (両端を含む) の範囲にまたがり、値が大きいほど一致の信頼度が高いことを示します。
name	string	エンティティの名前。

CropRegion

スマートトリミング用に識別されるリージョン。要求された縦横比ごとに 1 つのリージョンが返されます。

名前	型	説明
aspectRatio	number	トリミング領域の縦横比。
boundingBox	BoundingBox	画像内の領域の境界ボックス。

DenseCaption

画像が示す内容の簡単な説明。

名前	型	説明
boundingBox	BoundingBox	画像内の領域の境界ボックス。
confidence	number	キャプションにサービスが持つ信頼度。信頼度スコアは 0.0 から 1.0 (両端を含む) の範囲にまたがり、値が大きいほど一致の信頼度が高いことを示します。
text	string	キャプションのテキスト。

DenseCaptionsResult

キャプションの一覧。

名前	型	説明
values	DenseCaption[]	キャプションの一覧。

DetectedObject

画像内で検出されたオブジェクトについての説明。

名前	型	説明
boundingBox	BoundingBox	画像内の領域の境界ボックス。
id	string	検出されたオブジェクトの ID。
tags	ContentTag[]	検出されたオブジェクトの分類の信頼度。

DetectedPerson

画像内で検出された人物。

名前	型	説明
boundingBox	BoundingBox	画像内の領域の境界ボックス。
confidence	number	画像内の人物を観察したという信頼度スコア。信頼度スコアは 0.0 から 1.0 (両端を含む) の範囲にまたがり、値が大きいほど一致の信頼度が高いことを示します。

DetectedTextBlock

検出されたテキストブロック。

名前	型	説明
lines	DetectedTextLine[]	テキストブロック内のテキスト行の一覧。

DetectedTextLine

検出されたテキスト行。

名前	型	説明
boundingPolygon	ImagePoint[]	テキスト行の境界ポリゴン。
text	string	検出されたテキスト行のテキストコンテンツ。
words	DetectedTextWord[]	テキスト行の単語の一覧。

DetectedTextWord

連続する文字シーケンスで構成される単語が検出されました。中国語、日本語、韓国語などのスペースで区切られた言語以外の言語の場合、各文字は独自の単語として表されます。

名前	型	説明
boundingPolygon	ImagePoint[]	単語の境界ポリゴン。
confidence	number	単語が検出された信頼度。信頼度スコアは 0.0 から 1.0 (両端を含む) の範囲にまたがり、値が大きいほど一致の信頼度が高いことを示します。
text	string	単語のテキストコンテンツ。

ErrorResponse

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

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

ErrorResponseDetails

エラー情報。

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

ErrorResponseInnerError

詳細なエラー。

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

ImageAnalysisResult

さまざまな種類の画像分析の組み合わせ結果について説明します。

名前	型	説明
captionResult	CaptionResult	画像が示す内容の簡単な説明。
denseCaptionsResult	DenseCaptionsResult	キャプションの一覧。
metadata	ImageMetadata	高さと幅などの画像メタデータ情報。
modelVersion	string	モデルバージョン。
objectsResult	ObjectsResult	画像内で検出されたオブジェクトについて説明します。
peopleResult	PeopleResult	イメージに人物が含まれているかどうかを示すオブジェクト。
readResult	ReadResult	読み取り操作の結果。
smartCropsResult	SmartCropsResult	スマートトリミングの結果。
tagsResult	TagsResult	信頼度レベルを持つタグの一覧。

ImageMetadata

高さと幅などの画像メタデータ情報。

名前	型	説明
height	integer	画像の高さ (ピクセル単位)。
width	integer	画像の幅 (ピクセル単位)。

ImagePoint

イメージ内のポイントを表すオブジェクト。

名前	型	説明
x	integer	この点の x 座標。
y	integer	この点の y 座標。

ObjectsResult

画像内で検出されたオブジェクトについて説明します。

名前	型	説明
values	DetectedObject[]	検出されたオブジェクトの配列。

PeopleResult

イメージに人物が含まれているかどうかを示すオブジェクト。

名前	型	説明
values	DetectedPerson[]	検出されたユーザーの配列。

ReadResult

読み取り操作の結果。

名前	型	説明
blocks	DetectedTextBlock[]	テキストブロックの一覧。

SmartCropsResult

スマートトリミングの結果。

名前	型	説明
values	CropRegion[]	イメージをトリミングするための推奨領域。

TagsResult

信頼度レベルを持つタグの一覧。

名前	型	説明
values	ContentTag[]	信頼度レベルを持つタグの一覧。

VisualFeature

要求されたビジュアル機能。少なくとも 1 つのビジュアル機能を指定する必要があります。

名前	型	説明
caption	string	画像の内容を要約する説明またはキャプション。
denseCaptions	string	画像コンテンツの詳細な説明を提供する詳細なキャプション。
objects	string	イメージ内で認識され、ラベル付けされた特定のオブジェクト。
people	string	画像内のユーザーの検出と分析。
read	string	画像から抽出されたテキストコンテンツ (標識やラベルなど)。
smartCrops	string	重要なコンテンツに焦点を当てた画像のトリミングされたバージョンが自動的に生成されます。
tags	string	画像で検出されたオブジェクトを表すビジュアルタグ。

次の方法で共有

Analyze - Image Stream

URI パラメーター

要求本文

応答

例

ImageAnalysis_Analyze_MaximumSet_Gen

要求のサンプル

応答のサンプル

ImageAnalysis_Analyze_MinimumSet_Gen

要求のサンプル

応答のサンプル

定義

BoundingBox

CaptionResult

ContentTag

CropRegion

DenseCaption

DenseCaptionsResult

DetectedObject

DetectedPerson

DetectedTextBlock

DetectedTextLine

DetectedTextWord

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

ImageAnalysisResult

ImageMetadata

ImagePoint

ObjectsResult

PeopleResult

ReadResult

SmartCropsResult

TagsResult

VisualFeature

その他のリソース