顔検出 API の使い方：顔交換統合ガイド（2026）

顔検出 は NamiFusion の顔交換モデルです：入力要素に含まれる顔情報を検出するために使用される顔検出モデル。NamiFusion では Playground で試してから（送信前に見積もり表示）、統一 REST API で呼び出せます。

TL;DR

· タスク種別：顔交換（提供：NamiFusion）

· 料金：従量課金（$1 = 100 クレジット）、サブスク不要

· 始め方：Playground で試用（送信前に見積もり）→ API キー作成 → POST 一発で統合

· 調整可能パラメータ：8 個（下表参照）

· プラットフォーム透かしなし。商用利用可（利用規約に従う）

顔検出 で何が作れる？

映像・ショートドラマのポスプロ：再撮影の代替や多言語ローカライズで顔を差し替え。

ミーム・エンタメ：自分や友人の顔を名シーンに合成、SNS でシェアしやすい。

バーチャルペルソナとプライバシー：配信や出演コンテンツで代替顔を使用。

一括生産：同じ素材に複数のソース顔をマッピングし、パーソナライズ版を量産。

この API はどう呼び出す？

1. NamiFusion に登録し、API Keys ページでキーを作成（登録で無料クレジット）。

2. 下記の cURL 例でタスクを送信。Bearer トークンにキーを指定。

3. 返された task_uuid でステータスをポーリングし、完了後に出力 URL を取得。

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/namifusion/detect_faces" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "url": "https://assets-public.namifusion.com/marketplace/thumbnails/2026-02-25/fb559d5bc3dc.png",
    "num_frames": 5,
    "return_face_url": true,
    "single_face": false,
    "deduplicate": true,
    "similarity_threshold": 0.45,
    "time_range": {}
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

どんなパラメータがある？

url（メディアURL）：任意

img（Base64画像）：任意

num_frames（抽出フレーム数）：任意、デフォルト 5

return_face_url（顔URLを返す）：任意、デフォルト true

single_face（最大1顔のみ）：任意、デフォルト false

deduplicate（顔重複除去）：任意、デフォルト true

similarity_threshold（類似度しきい値）：任意、デフォルト 0.45

time_range（時間範囲）：任意、デフォルト {}

顔検出 のプロンプトの書き方は？

1. 主体を先に：主役と動作を先に書き、環境・光・スタイルを後から足す（「雨のネオン街を走る宇宙飛行士、シネマティック、浅い被写界深度」）。

2. 形容詞の羅列より具体名詞：「85mm ポートレートレンズ、夕暮れの逆光」は「とても綺麗、超高品質」より遥かに効く。

3. 1 回の反復で変えるのは 1 変数だけ：seed を固定して再現し、語句を 1 つずつ調整する。

4. 否定は肯定で書く：「ぼかさない」ではなく「シャープなフォーカス、精細なディテール」と指定。

料金はいくら？

従量課金（$1 = 100 クレジット）。パラメータにより変動し、Playground で送信前に見積もりを確認できます。