Skip to main content
本文では、五官定位 API 対接説明を紹介します。これは、画像を入力することで、リクエストされた画像の五官を定位（顔のキーポイント定位とも呼ばれる）し、顔の輪郭を構成する90のポイントを計算します。これには、眉毛（左右それぞれ8ポイント）、目（左右それぞれ8ポイント）、鼻（13ポイント）、口（22ポイント）、顔の輪郭（21ポイント）、眼球[または瞳孔]（2ポイント）が含まれます。

​
申請プロセス

APIを使用するには、まず五官定位 APIの該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように： まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。 初回申請時には無料のクレジットが付与され、このAPIを無料で使用できます。

​
基本的な使用法

まず、基本的な使用方法を理解します。画像リンクを入力するだけで、処理後の結果画像を得ることができます。まず、image_urlフィールドを簡単に渡す必要があります。顔の画像は以下の図のように：

次に、画面上に対応する内容を記入できます。以下の図のように：

ここでは、Request Headersを設定しました。これには以下が含まれます：
  • accept：受け取りたいレスポンス結果の形式。ここではapplication/json、すなわちJSON形式を記入します。
  • authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
さらに、Request Bodyを設定しました。これには以下が含まれます：
  • image_url：処理する顔の画像リンク。
  • mode：検出モード。0はすべての顔を検出し、1は面積が最大の顔を検出します。デフォルトは0です。
  • face_model_version：顔認識サービスで使用されるアルゴリズムモデルのバージョン。デフォルトは3.0です。
  • need_rotate_detection：画像の回転認識サポートを有効にするかどうか。0は無効、1は有効。デフォルトは0です。
選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：

「Try」ボタンをクリックするとテストを行うことができます。上の図のように、ここで以下の結果を得ました：
この時点で、画像中の顔に関する情報、顔の特徴点（顔のキーポイント）の具体的な情報、顔認識に使用されるアルゴリズムモデルのバージョンなどが得られました。 フィールドの説明は以下の通りです：
  • image_width ：要求された画像の幅。
  • image_height ：要求された画像の高さ。
  • face_model_version：顔認識に使用されるアルゴリズムモデルのバージョン。
  • face_shape_set：五官の位置（顔の重要点）の具体的な情報。
    • face_profile ：顔の輪郭を表す21点。
      • x ：x座標
      • y ：y座標
    • left_eye ：左側の目の輪郭を表す8点。
      • x ：x座標
      • y ：y座標
    • right_eye ：右側の目の輪郭を表す8点。
      • x ：x座標
      • y ：y座標
    • left_eye_brow ：左側の眉毛の輪郭を表す8点。
      • x ：x座標
      • y ：y座標
    • right_eye_brow ：右側の眉毛の輪郭を表す8点。
      • x ：x座標
      • y ：y座標
    • mouth ：口の輪郭を表す22点。
      • x ：x座標
      • y ：y座標
    • nose ：鼻の輪郭を表す13点。
      • x ：x座標
      • y ：y座標
    • left_pupil ：左瞳孔の輪郭を表す1点。
      • x ：x座標
      • y ：y座標
    • right_pupil ：右瞳孔の輪郭を表す1点。
      • x ：x座標
      • y ：y座標
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです：
Pythonの接続コードは以下の通りです：

​
エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 401 invalid_token：認証されていない、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、五官位置APIを使用して入力画像の五官位置を特定する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。