コンピューター ビジョン API
この Azure Cognitive Service では、画像から豊富な情報を抽出し、ビジュアル データの分類および加工を行うことで、望ましくないコンテンツからユーザーを保護できます。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | リージョン |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域 |
| Power Automate | Standard | すべての Power Automate 地域 |
| Power Apps | Standard | すべての Power Apps 地域 |
| Contact | |
|---|---|
| 件名 | マイクロソフト |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| 公開元 | Microsoft |
| Web サイト | https://azure.microsoft.com/services/cognitive-services/computer-vision/ |
この統合を使用するには、Azure ポータルの Cognitive Service リソース が必要です。 エンドポイントとアプリケーションを認証するためのキーを取得します。 接続するには、アカウント キーとサイトの URL を入力し、接続の作成を選択します。 接続の運用コストについては、ここ で詳細を確認してください。
これで、この統合の使用を開始する準備が整いました。
既知の問題と制限事項
機械学習やパターン認識に基づく 認知サービス API の性質上、操作結果が不完全になることがありますのでご了承ください。
Microsoft Entra ID との接続
Microsoft Entra ID との接続を作成するには、アカウントに Cognitive Services ユーザー ロールを追加してアクセスする必要があります。 この接続を使用するには、サポートされている操作に Cognitive Services リソースに関連付けられている一意のサブドメインを入力する必要があります。
Microsoft Entra ID 認証でサポートされていない操作
Microsoft Entra ID 認証を使用する場合、V3 アクションのみがサポートされています。 非推奨アクションは引き続き Access Key 認証で機能しますが、Microsoft Entra AAD 接続で使用すると失敗します。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| API キー | ApiKey | すべての地域 | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
API キー
認証 ID: keyBasedAuth
適用できるもの: すべての領域
ApiKey
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| アカウント キー | securestring | Cognitive Services アカウント キー | 真 |
| サイトの URL | 文字列 | ルート サイト URL (例: https://westus.api.cognitive.microsoft.com) |
既定 [非推奨]
適用できるもの: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名称 | タイプ | 内容 | 必要 |
|---|---|---|---|
| アカウント キー | securestring | Cognitive Services アカウント キー | 真 |
| サイトの URL | 文字列 | ルート サイト URL (例: https://westus.api.cognitive.microsoft.com)。指定されていない場合、サイトの URL は既定で 'https://westus.api.cognitive.microsoft.com' になります。 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| オブジェクトを検出する |
指定された画像内で検出されたオブジェクトのリストを生成します。 |
| オブジェクトを検出する (V3) (プレビュー) |
指定された画像内で検出されたオブジェクトのリストを生成します。 |
| サムネイルを生成する |
この操作を実行すると、サムネイル画像が、ユーザーが指定した幅と高さで生成されます。 |
| サムネイルを生成する (V3) (プレビュー) |
この操作を実行すると、サムネイル画像が、ユーザーが指定した幅と高さで生成されます。 |
| タグ画像 (V3) (プレビュー) |
指定された画像の内容に関連する単語またはタグのリストを生成します。 |
| ドメイン固有のコンテンツを認識する |
画像内の著名人や象徴的な建物を認識します。 |
| ドメイン固有のコンテンツを認識する (V3) (プレビュー) |
画像内の著名人や象徴的な建物を認識します。 |
| 光学式文字認識 (OCR) で JSON に抽出 |
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をコンピューターで使用できる JSON ストリームに抽出します。 |
| 光学式文字認識 (OCR) で JSON に抽出する (V3) (プレビュー) |
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をコンピューターで使用できる JSON ストリームに抽出します。 |
| 光学式文字認識 (OCR) でテキストに抽出 |
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をテキスト ファイルに抽出します。 |
| 光学式文字認識 (OCR) でテキストに抽出する (V3) (プレビュー) |
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をテキスト ファイルに抽出します。 |
| 画像 URL を説明する (V3) (プレビュー) |
この操作を実行すると、画像の URL が、ユーザーが読み取れる言語による完全な文で生成されます。 |
| 画像の URL を記述する |
この操作を実行すると、画像の URL が、ユーザーが読み取れる言語による完全な文で生成されます。 |
| 画像の内容を記述する |
この操作を実行すると、画像コンテンツの記述が、ユーザーが読み取れる言語による完全な文で生成されます。 |
| 画像の内容を説明する (V3) (プレビュー) |
この操作を実行すると、画像コンテンツの記述が、ユーザーが読み取れる言語による完全な文で生成されます。 |
| 画像の分析 |
この操作を実行すると、画像コンテンツに基づいて特徴的なビジュアルが豊富に抽出されます。 |
| 画像をタグ付け |
指定された画像の内容に関連する単語またはタグのリストを生成します。 |
| 画像を分析する (V3) (プレビュー) |
この操作を実行すると、画像コンテンツに基づいて特徴的なビジュアルが豊富に抽出されます。 |
| 画像を記述する |
この操作を実行すると、画像の記述が、ユーザーが読み取れる言語による完全な文で生成されます。 |
| 画像を説明する (V3) (プレビュー) |
この操作を実行すると、画像の記述が、ユーザーが読み取れる言語による完全な文で生成されます。 |
| 関心ある分野を取得する (V3) (プレビュー) |
画像の最も重要な領域の周囲の境界ボックスを返します。 |
| 関心の領域を取得する |
画像の最も重要な領域の周囲の境界ボックスを返します。 |
オブジェクトを検出する
指定された画像内で検出されたオブジェクトのリストを生成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- DetectResponse
オブジェクトを検出する (V3) (プレビュー)
指定された画像内で検出されたオブジェクトのリストを生成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- DetectResponse
サムネイルを生成する
この操作を実行すると、サムネイル画像が、ユーザーが指定した幅と高さで生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サムネイルの幅
|
width | True | number |
生成するサムネイルの幅 - 推奨値は 50 です |
|
サムネイルの高さ
|
height | True | number |
生成するサムネイル画像の高さ - 推奨値は 50 です |
|
スマート なトリミング
|
smartCropping | boolean |
スマート なトリミングを可能にするブール型フラグ |
|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
生成されたサムネイル画像
- サムネイル
- binary
サムネイルを生成する (V3) (プレビュー)
この操作を実行すると、サムネイル画像が、ユーザーが指定した幅と高さで生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
サムネイルの幅
|
width | True | number |
生成するサムネイルの幅 - 推奨値は 50 です |
|
サムネイルの高さ
|
height | True | number |
生成するサムネイル画像の高さ - 推奨値は 50 です |
|
スマート なトリミング
|
smartCropping | boolean |
スマート なトリミングを可能にするブール型フラグ |
|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
生成されたサムネイル画像
- サムネイル
- binary
タグ画像 (V3) (プレビュー)
指定された画像の内容に関連する単語またはタグのリストを生成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- TagResponse
ドメイン固有のコンテンツを認識する
画像内の著名人や象徴的な建物を認識します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドメイン モデル
|
model | True | string |
画像の認識をサポートするドメイン固有のモデルです。 |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- DomainModelResponse
ドメイン固有のコンテンツを認識する (V3) (プレビュー)
画像内の著名人や象徴的な建物を認識します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
ドメイン モデル
|
model | True | string |
画像の認識をサポートするドメイン固有のモデルです。 |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- DomainModelResponse
光学式文字認識 (OCR) で JSON に抽出
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をコンピューターで使用できる JSON ストリームに抽出します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- JSON 応答
- OCRJsonResponse
光学式文字認識 (OCR) で JSON に抽出する (V3) (プレビュー)
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をコンピューターで使用できる JSON ストリームに抽出します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- JSON 応答
- OCRJsonResponse
光学式文字認識 (OCR) でテキストに抽出
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をテキスト ファイルに抽出します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- OCRTextResponse
光学式文字認識 (OCR) でテキストに抽出する (V3) (プレビュー)
光学式文字認識 (OCR) により、画像内のテキストを検出し、認識された文字をテキスト ファイルに抽出します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- OCRTextResponse
画像 URL を説明する (V3) (プレビュー)
この操作を実行すると、画像の URL が、ユーザーが読み取れる言語による完全な文で生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
最大候補数
|
maxCandidates | number |
返される候補の記述の最大数です。 |
|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像の URL
|
url | url |
URL 別の画像参照のソースです。 |
戻り値
- 本文
- DescribeResponse
画像の URL を記述する
この操作を実行すると、画像の URL が、ユーザーが読み取れる言語による完全な文で生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
最大候補数
|
maxCandidates | number |
返される候補の記述の最大数です。 |
|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像の URL
|
url | url |
URL 別の画像参照のソースです。 |
戻り値
- 本文
- DescribeResponse
画像の内容を記述する
この操作を実行すると、画像コンテンツの記述が、ユーザーが読み取れる言語による完全な文で生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
最大候補数
|
maxCandidates | number |
返される候補の記述の最大数です。 |
|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像の内容
|
Image | True | binary |
本文の画像参照のソースです。 |
戻り値
- 本文
- DescribeResponse
画像の内容を説明する (V3) (プレビュー)
この操作を実行すると、画像コンテンツの記述が、ユーザーが読み取れる言語による完全な文で生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
最大候補数
|
maxCandidates | number |
返される候補の記述の最大数です。 |
|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像コンテンツ
|
Image | True | binary |
本文の画像参照のソースです。 |
戻り値
- 本文
- DescribeResponse
画像の分析
この操作を実行すると、画像コンテンツに基づいて特徴的なビジュアルが豊富に抽出されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- AnalyzeResponse
画像をタグ付け
指定された画像の内容に関連する単語またはタグのリストを生成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- TagResponse
画像を分析する (V3) (プレビュー)
この操作を実行すると、画像コンテンツに基づいて特徴的なビジュアルが豊富に抽出されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- AnalyzeResponse
画像を記述する
この操作を実行すると、画像の記述が、ユーザーが読み取れる言語による完全な文で生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
最大候補数
|
maxCandidates | number |
返される候補の記述の最大数です。 |
|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- DescribeResponse
画像を説明する (V3) (プレビュー)
この操作を実行すると、画像の記述が、ユーザーが読み取れる言語による完全な文で生成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
最大候補数
|
maxCandidates | number |
返される候補の記述の最大数です。 |
|
|
言語
|
language | string |
指定した言語で認識した結果が戻されます。 |
|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
- 本文
- DescribeResponse
関心ある分野を取得する (V3) (プレビュー)
画像の最も重要な領域の周囲の境界ボックスを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リソースのサブドメインや地域
|
subdomainName | True | string |
Azure のサブドメインまたは地理的地域 (例: westus) |
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
関心の領域を取得する
画像の最も重要な領域の周囲の境界ボックスを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
画像のソース
|
format | True | string |
画像のソースです。画像は含まれているか、URL で参照されています。 |
|
Image
|
Image | True | dynamic |
戻り値
定義
DomainModelResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
著名人
|
result.celebrities | array of object |
画像内で認識された著名人 |
|
著名人信頼度
|
result.celebrities.confidence | float |
画像が著名人であることの信頼度スコア |
|
著名人の名前
|
result.celebrities.name | string |
認識された著名人の名前 |
|
ランドマーク
|
result.landmarks | array of object |
画像内で認識された象徴的建物 |
|
象徴的建物信頼度
|
result.landmarks.confidence | float |
画像が象徴的建物であることの信頼度スコア |
|
象徴的建物の名前
|
result.landmarks.name | string |
識別された象徴的建物の名前 |
TagResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
タグ
|
tags | array of object |
画像分析から返されたタグのセットです。 |
|
タグの信頼度スコア
|
tags.confidence | float |
識別されたタグの信頼度スコアです。 |
|
タグ名
|
tags.name | string |
識別されたタグの名前。 |
DetectResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
オブジェクト
|
objects | array of object |
画像分析から返されたオブジェクトのセットです。 |
|
オブジェクトの信頼度スコア
|
objects.confidence | float |
識別されたオブジェクトの信頼度スコアです。 |
|
オブジェクト名
|
objects.object | string |
識別されたオブジェクトの名前です。 |
AreaOfInterestResponse
OCRJsonResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
テキストの言語
|
language | string |
検出された画像テキストの言語です。 |
|
領域配列
|
regions | array of object |
返されたテキストの領域です。 |
OCRTextResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
検出されたテキスト
|
text | string |
分析された画像内で検出されたテキスト |
AnalyzeResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
カテゴリ
|
categories | array of object |
画像から識別されたカテゴリ |
|
カテゴリ名
|
categories.name | string |
画像から識別されたカテゴリの名前 |
|
カテゴリの信頼度スコア
|
categories.score | float |
画像カテゴリの信頼度スコア |
|
キャプション
|
description.captions | array of object |
画像から生成されたキャプションを一覧表示する |
|
キャプションの信頼度スコア
|
description.captions.confidence | float |
画像キャプションの信頼度スコア |
|
キャプション テキスト
|
description.captions.text | string |
画像から生成されたテキスト キャプション |
|
タグ名
|
description.tags | array of string |
タグ名のコレクションです。 |
|
タグ
|
tags | array of object |
信頼度スコアで識別されるタグです。 |
|
タグの信頼度スコア
|
tags.confidence | float |
識別されたタグの信頼度スコアです。 |
|
タグ名
|
tags.name | string |
識別されたタグの名前。 |
DescribeResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
キャプション
|
description.captions | array of object |
画像から生成されたキャプションを一覧表示する |
|
キャプションの信頼度スコア
|
description.captions.confidence | float |
画像キャプションの信頼度スコア |
|
キャプション テキスト
|
description.captions.text | string |
画像から生成されたテキスト キャプション |
|
タグ名
|
description.tags | array of string |
タグ名のコレクションです。 |
バイナリ
これは基本的なデータ型 [バイナリ] です。