Image Moderation - Find Faces Url Input

  • リファレンス
サービス:
Cognitive Services
API バージョン:
1.0

見つかった顔の一覧を返します。

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces
省略可能なパラメーターを含む: 
POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url&CacheImage={CacheImage}

URI パラメーター

名前 / 必須 型 説明
Endpoint
 path True

string

サポートされている Azure Cognitive Services エンドポイント (プロトコルとホスト名など https://westus.api.cognitive.microsoft.com)。
CacheImage
 query

boolean

送信された画像を将来の使用のために保持するかどうか。 省略した場合、既定値は false です。

要求ヘッダー

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

string

Content-Type True

string

コンテンツ タイプ。

要求本文

名前 型 説明
DataRepresentation

string

Value

string

応答

名前 型 説明
200 OK

FoundFaces

見つかった顔の一覧。
Other Status Codes

APIError

エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

例

Find Faces request

要求のサンプル

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url



{
  "DataRepresentation": "URL",
  "Value": "https://moderatorsampleimages.blob.core.windows.net/samples/img_300.jpg"
}

応答のサンプル

状態コード:
200 
{
  "Faces": [
    {
      "Left": 80,
      "Right": 118,
      "Top": 44,
      "Bottom": 82
    }
  ],
  "Count": 1,
  "AdvancedInfo": [],
  "Result": true,
  "Status": {
    "Code": 3000,
    "Description": "OK",
    "Exception": ""
  },
  "TrackingId": "SEA_ad975eeae1f24f81bebb40be0c3ba4fd_ContentModerator.Preview_01158625-4fea-4dd5-8f21-5e2657ea2eee"
}

定義

名前 説明
APIError

API から返されるエラー情報。
Error

エラー本文。
Face

見つかった面への座標。
FoundFaces

見つかった顔を含む Request オブジェクト。
KeyValuePair

キーと値のペア オブジェクトのプロパティ。
Status

状態プロパティ。

APIError

API から返されるエラー情報。

名前 型 説明
Error

Error

エラー本文。

Error

エラー本文。

名前 型 説明
Code

string

Message

string

Face

見つかった面への座標。

名前 型 説明
Bottom

integer

下座標。
Left

integer

左座標。
Right

integer

右座標。
Top

integer

上座標。

FoundFaces

見つかった顔を含む Request オブジェクト。

名前 型 説明
AdvancedInfo

KeyValuePair[]

詳細な情報。
CacheId

string

キャッシュ ID。
Count

integer

検出された顔の数。
Faces

Face[]

顔の一覧。
Result

boolean

True の場合、結果が見つかりました。
Status

Status

評価の状態。
TrackingId

string

追跡 ID。

KeyValuePair

キーと値のペア オブジェクトのプロパティ。

名前 型 説明
Key

string

キー パラメーター。
Value

string

値パラメーター。

Status

状態プロパティ。

名前 型 説明
Code

integer

状態コード。
Description

string

状態の説明。
Exception

string

例外の状態。