顔の比率分析

統合ガイド

• 顔の比率分析 用に写真を撮る方法

• 正面を向いた自撮り写真を撮る

  • 鮮明な写真 1 枚で、カメラにまっすぐ向き合ってください。髪は自然な状態にし、顔全体が隠れることなく見える状態がベストです。おでこを出すために髪を流し、まっすぐ正面を見つめることで、適切な正面からのアングルを撮影してください。
  • または、JS Camera Kit を使用して写真を撮影してください。自動的な顔アラインメント、ライティングのガイド、顔サイズ検出に従い、写真が処理に必要な基準を満たすことを確認してください。

• AI による肌の悩みの検出方法

1. ソース画像のサイズを変更する
   写真のサイズをサポートされている寸法に合わせてください。詳細は ファイル仕様とエラー

2. File API を使用してファイルをアップロードする
   /s2s/v2.0/file API を使用して、対象のユーザー画像をアップロードします。

   • 画像の要件
     • 詳細は ファイル仕様とエラー をご覧ください。 重要: File API を呼び出すだけでは、ファイルはアップロードされません。File API レスポンスで提供された URL へファイルを 手動でアップロード する必要があります。その URL がアップロード先です。続行する前に、ファイルがそこに正常に転送されたことを確認してください。
       AI API を呼び出す前に、ファイルが正常にアップロード済みであることを確認してください。File API を使用してアップロード用 URL を取得し、その場所にファイルをアップロードします。アップロードが完了すると、レスポンスで file_id を受け取ります。この ID を使用して、そのファイルに関連する AI 機能にアクセスします。

   警告: File API レスポンスで提供された URL へファイルをアップロードせずに AI API を使用すると、500 Server Error / unknown_internal_error または 404 Not Found のエラーが発生する点にご注意ください。

3. 顔の比率分析 タスクを実行する
   アップロードが完了すると、ファイル ID を使用して分析する複数の顔属性を選択できます。 入力と出力 を参照してください。
   その後、File ID を用いて POST 'task/face-attr-analysis' を呼び出すと、 enhance タスクが実行され、task_id が取得されます。

4. タスクが成功またはエラーになるまでポーリングでステータスを確認する
   この task_id を使用して、GET 'task/face-attr-analysis' をポーリングし、現在のエンジンステータスを取得してタスクのステータスを監視します。エンジンがタスクを完了するまで、ステータスは 'running' のままで、この段階ではユニットは消費されません。

   警告: タスクの保持期間に基づいて ポーリング でタスクのステータスを確認することは必須です。保持期間内にポーリングリクエストがなければ、タスクが正常に処理されていても、タスクはタイムアウトします（ユニットは消費されます）。

   警告: タイムアウトしたタスクのステータスを確認すると、InvalidTaskId エラーが発生します。そのため、AI タスクを実行したら、保持期間内に ポーリング でステータスを確認し、ステータスが success または error になるまで続行する必要があります。

5. AI タスクが成功したら結果を取得する
   エンジンが入力ファイルを正常に処理し、結果画像を生成すると、タスクは 'success' ステータスに変更されます。処理された画像の URL と、結果画像を再アップロードせずに別の AI タスクを連続実行できる dst_id を受け取ります。 ユニットは、この場合にのみ消費されます。エンジンがタスクの処理に失敗すると、タスクのステータスは 'error' に変更され、ユニットは消費されません。
   ユニットを控除する際、システムは期限の近づいているものを優先します。期限が同じ場合は、最も早く取得したユニットを控除します。

• 実際の使用例:

入力と出力

• 顔属性:

• 顔比率:

• 撮影方法の提案:

警告: 顔の幅は、画像の幅の 60% を超える必要があります。

ファイル仕様とエラー

• 対応形式と解像度

• エラーコード

• 環境と依存関係

JS カメラキット

ユニット消費

• 顔属性・比率分析