このトピックでは、顔検索機能の使用方法と課金方法について説明します。
初めての使用
初めて顔検索機能を簡単にテストする場合は、次の手順を実行します。
人物を追加します。 詳細については、「人物を追加するための API 操作」をご参照ください。
説明グループが存在しない場合、人物を追加する操作によってグループが自動的に作成されます。 グループが既に存在する場合、操作によってそのグループに人物が追加されます。
顔を追加します。 詳細については、「顔を追加するための API 操作」をご参照ください。
説明顔画像の HTTP または HTTPS URL を送信できます。 この方法を使用することをお勧めします。 ローカル画像ファイルを送信することもできます。 詳細については、SDK の例をご参照ください。
指定されたグループから特定の顔を検索します。 詳細については、「カスタム顔検索」をご参照ください。
説明1 つの検索リクエストで指定できるグループは 1 つだけです。 複数のグループで検索を実行する場合は、この操作を複数回呼び出して、異なるグループ ID を指定する必要があります。
（オプション） 人物情報を設定します。 人物に追加情報を追加する必要がある場合は、この操作を呼び出すことができます。 詳細については、「人物情報を設定するための API 操作」をご参照ください。 対応する人物が検索されると、検索された顔画像に関する情報が返されます。
制限事項
検索対象の画像では、複数の顔がサポートされています（M:N モードの顔検索）。 デフォルトでは、1 つの画像で最大 20 個の顔がサポートされています。
検索された顔画像ごとに、デフォルトで類似度の高い 5 人の ID が返されます。 スコアが最も高い人物の ID を結果として使用することをお勧めします。
検索操作では、対応する画像は返されません。 顔ライブラリの画像と人物のマッピングを保存する必要があります。
人物が属するグループの変更
人物が属するグループを変更するには、次の手順を実行します。
グループから人物を削除します。 詳細については、「グループから人物を削除するための API 操作」をご参照ください。
説明グループから人物を削除しても、その人物の画像は削除されません。
新しいグループに人物を追加します。 詳細については、「グループに人物を追加するための API 操作」をご参照ください。
説明この操作を呼び出す前に、新しいグループが既に存在することを確認してください。 グループが存在しない場合は、エラーが返されます。
課金方法
この操作の呼び出しに対して課金されます。 課金方法の詳細については、
顔検索機能では、カスタム顔検索顔を登録する 操作と 操作の呼び出しに対して課金されます。 その他の操作は無料です。