Skip to main content
本文では、人顔性別変換 API 接続説明を紹介します。これは、ユーザーが顔画像をアップロードすることで、人顔編集と生成アルゴリズムに基づいて、顔の性別を変換した画像を出力します。男性から女性への変換では、美顔、薄化粧、前髪、長髪の効果を実現できます。女性から男性への変換では、ひげを加えたり、短髪にする効果を実現できます。

​
申請プロセス

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

​
基本使用

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

次に、顔の性別情報パラメータ gender_infos をアップロードする必要があります。これは配列であり、複数の情報を渡すことができます。次に、画面上に対応する内容を記入できます。以下の図のように：

ここでは、Request Headers を設定しました。これには以下が含まれます：
  • accept：受け取りたいレスポンス結果の形式。ここでは application/json、つまり JSON 形式を記入します。
  • authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
また、Request Body を設定しました。これには以下が含まれます：
  • image_url：処理する顔画像のリンク。
  • gender_infos：顔の性別と領域情報。性別は必須パラメータで、0は男性から女性への変換、1は女性から男性への変換を示します。
選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：

「Try」ボタンをクリックするとテストができます。上の図のように、以下の結果が得られました：
ここで返された結果には、入力された性別変化パラメータに基づいて変化した顔画像の image_url フィールドがあります。変化後の顔情報は以下の図のように：

画像中の顔は、入力された性別に基づいて変化しています。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです：
Python の接続コードは以下の通りです：

​
エラー処理

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

​
エラー応答の例

​
結論

この文書を通じて、ユーザーがアップロードした顔画像を基に、人顔編集と生成アルゴリズムを使用して、人顔性別変換の画像を出力する方法を理解しました。この文書が、APIの接続と使用をより良くする手助けとなることを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。