クイック スタート:Face REST API と cURL を使用して画像から顔を検出するQuickstart: Detect faces in an image using the Face REST API and cURL

このクイック スタートでは、Azure Face REST API と cURL を使用して、画像から人の顔を検出します。In this quickstart, you will use the Azure Face REST API with cURL to detect human faces in an image.

Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。If you don't have an Azure subscription, create a free account before you begin.

前提条件Prerequisites

コマンドを作成するWrite the command

Face API を呼び出して、顔の属性データを画像から取得するには、次のようなコマンドを使用します。You will use a command like the following to call the Face API and get face attribute data from an image. まず、テキスト エディターにコードをコピーしてください。実行する前に、コマンドの一部に変更を加える必要があります。First, copy the code into a text editor—you'll need to make changes to certain parts of the command before you can run it.

curl -H "Ocp-Apim-Subscription-Key: <Subscription Key>" "https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect?returnFaceId=true&returnFaceLandmarks=false&returnFaceAttributes=age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise" -H "Content-Type: application/json" --data-ascii "{\"url\":\"https://upload.wikimedia.org/wikipedia/commons/c/c3/RH_Louise_Lillian_Gish.jpg\"}"

Subscription keySubscription key

<Subscription Key> を、有効な Face サブスクリプション キーに置き換えます。Replace <Subscription Key> with your valid Face subscription key.

Face エンドポイント URLFace endpoint URL

URL https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect は、照会する Azure Face エンドポイントを示します。The URL https://westcentralus.api.cognitive.microsoft.com/face/v1.0/detect indicates the Azure Face endpoint to query. この URL の最初の部分は、実際のサブスクリプション キーに対応するリージョンと一致するように変更する必要があります (全リージョンのエンドポイント一覧については、Face API のドキュメントを参照)。You may need to change the first part of this URL to match the region that corresponds to your subscription key (see the Face API docs for a list of all region endpoints).

URL クエリ文字列URL query string

取得する顔の属性は、Face エンドポイント URL のクエリ文字列で指定します。The query string of the Face endpoint URL specifies which face attributes to retrieve. この文字列は、実際の用途に合わせて変更してください。You may wish to change this string depending on your intended use.

?returnFaceId=true&returnFaceLandmarks=false&returnFaceAttributes=age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise

イメージ ソース URLImage source URL

ソース URL は、入力として使用する画像を示します。The source URL indicates the image to use as input. 実際の分析対象となる画像を指すように変更してください。You can change this to point to any image you wish to analyze.

https://upload.wikimedia.org/wikipedia/commons/c/c3/RH_Louise_Lillian_Gish.jpg

コマンドを実行しますRun the command

変更を加えたら、コマンド プロンプトを開いて新しいコマンドを入力します。Once you've made your changes, open a command prompt and enter the new command. コンソール ウィンドウに、顔の情報が JSON データとして表示されます。You should see the face information displayed as JSON data in the console window. 例: For example:

[
  {
    "faceId": "49d55c17-e018-4a42-ba7b-8cbbdfae7c6f",
    "faceRectangle": {
      "top": 131,
      "left": 177,
      "width": 162,
      "height": 162
    },
    "faceAttributes": {
      "smile": 0,
      "headPose": {
        "pitch": 0,
        "roll": 0.1,
        "yaw": -32.9
      },
      "gender": "female",
      "age": 22.9,
      "facialHair": {
        "moustache": 0,
        "beard": 0,
        "sideburns": 0
      },
      "glasses": "NoGlasses",
      "emotion": {
        "anger": 0,
        "contempt": 0,
        "disgust": 0,
        "fear": 0,
        "happiness": 0,
        "neutral": 0.986,
        "sadness": 0.009,
        "surprise": 0.005
      },
      "blur": {
        "blurLevel": "low",
        "value": 0.06
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.67
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0
      },
      "makeup": {
        "eyeMakeup": true,
        "lipMakeup": true
      },
      "accessories": [],
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "hair": {
        "bald": 0,
        "invisible": false,
        "hairColor": [
          {
            "color": "brown",
            "confidence": 1
          },
          {
            "color": "black",
            "confidence": 0.87
          },
          {
            "color": "other",
            "confidence": 0.51
          },
          {
            "color": "blond",
            "confidence": 0.08
          },
          {
            "color": "red",
            "confidence": 0.08
          },
          {
            "color": "gray",
            "confidence": 0.02
          }
        ]
      }
    }
  }
]

次の手順Next steps

このクイック スタートでは、Azure Face API 呼び出しにより画像から顔を検出してその属性を返す cURL コマンドを作成しました。In this quickstart, you wrote a cURL command that calls the Azure Face API to detect faces in an image and return their attributes. この後は、Face API のリファレンス ドキュメントでさらに理解を深めましょう。Next, explore the Face API reference documentation to learn more.