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

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

TL;DR

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

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

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

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

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

顔検出 で何が作れる？

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

ミーム・エンタメ：自分や友人の顔を名シーンに合成、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/facedetect" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "frame_urls": [
      "https://assets-public.namifusion.com/marketplace/thumbnails/2026-02-25/fb559d5bc3dc.png"
    ],
    "expand_ratio": 0.3
  }
}'

# 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"

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

frame_urls（フレームURL一覧）：必須

timestamps（タイムスタンプ一覧）：任意

expand_ratio（顔切り抜き拡張比率）：任意、デフォルト 0.3

料金はいくら？

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