ドキュメント

使い方

画像を1枚 POST すると、写っている顔ごとの結果が JSON で返ります。

呼び出し先

POST https://www.ikachi.org/facelevel/api/v1/predict

送るもの

場所	名前	内容
ヘッダ	`X-API-Key`	発行したAPIキー（`Authorization: Bearer ...` でも可）
本文	`file`	画像1枚（`multipart/form-data`）。JPEG か PNG、10MB まで

例（curl）

curl -X POST https://www.ikachi.org/facelevel/api/v1/predict \
  -H "X-API-Key: fsk_あなたのキー" \
  -F "[email protected]"

返ってくるもの

{
  "success": true,
  "faces_detected": 1,
  "results": [
    {
      "face_id": 0,
      "score": 66.2,          // 顔面偏差値
      "raw_score": 3.648,     // 生のスコア（1〜5）
      "age": 33.1,            // 推定年齢
      "gender": "male",       // "male" / "female"
      "gender_prob": 1.0,     // 性別の確からしさ（0〜1）
      "bbox": { "x": 126, "y": 11, "width": 222, "height": 309 }  // 顔の位置（px）
    }
  ],
  "usage": { "plan": "free", "used_today": 1, "limit_today": 20 }
}

顔が複数写っていれば、results に顔の数だけ並びます。
うまくいかなかったときの応答はエラーと回数制限をご覧ください。

ご注意

送信された画像は、本APIの提供と品質の維持・改善のために当社で保存します（利用規約第5条）。
ご本人の同意なく他人の写真を送ること、採用・与信など人の選別に使うことは禁止しています。
結果はAIによる推定値です。正確さは保証しません。