リアルタイム顔交換APIガイド：カメラ・RTC配信への組み込み（2026年版）

リアルタイム顔交換APIは、Webカメラや RTCストリームといったライブ映像の顔を、ファイルの後処理ではなくその場で置き換えます。NamiFusionはこれを、Bearer APIキーで認証するREST APIとして提供し、ライブ状態を配信するSSE（Server-Sent Events）ストリーム、さらにコードを書く前に品質を検証できるデスクトップ版Playgroundを備えています。登録時に無料クレジットが付き、利用料は1ドル=100クレジットのクレジット制です。

要点まとめ（TL;DR）

処理対象はライブのカメラ映像とRTCストリームで、アップロード済みファイルに限りません。

Bearer APIキーによるREST送信。SSEイベントストリームが状態をリアルタイムで通知します。

デスクトップ版Playgroundを使えば、組み込み前に自分のカメラでテストできます。

プロトコルの完全なドキュメントはNamiFusionサイト内のAPIストアにあり、キーは/api-keysで作成します。

登録時の無料クレジットで実験でき、その後は1ドル=100クレジットの従量課金です。

リアルタイム顔交換APIの仕組みは？

フローは3段階です。第一に、Bearer APIキーで認証したREST経由でセッションを送信し、適用するソース顔をNamiFusionに伝えます。第二に、SSEイベントストリームを購読します。セッション準備完了、処理中、エラーといった状態更新が発生した瞬間にプッシュされるので、闇雲なポーリングは不要です。第三に、ライブソース（Webカメラや RTCストリーム）がスワップエンジンを通過し、顔が置き換わった映像として出力されます。

正確なエンドポイント、セッションパラメータ、イベントペイロードは、サイト内APIストアのリアルタイム顔交換ドキュメントページに、NamiFusionの他の98以上のマーケットプレイスモデルと並んで掲載されています。

セットアップの手順は？

1. NamiFusionアカウントを作成します。登録時の無料クレジットはテストにぴったりです。

2. /api-keysページでAPIキーを生成し、安全に保管します。このキーはすべてのリクエストのAuthorizationヘッダーに入れます。

3. APIストアのリアルタイム顔交換ドキュメントを開き、コードを書く前にセッションのライフサイクルを一読します。

4. デスクトップ版Playgroundを入手し、自分のカメラでライブテストを実行します。数分で品質がユースケースに合うか判断できます。

5. バックエンドからBearer認証付きのRESTでセッションを送信します。

6. SSEイベントストリームを購読し、ポーリングではなくイベントでアプリの状態を制御します。

7. カメラまたはRTCストリームを接続して出力を検証したら、テスト用クレジットから本番用の残高に切り替えて運用を開始します。

# Every request authenticates with the API key from /api-keys
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/<model_id>" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "face_image_url": "https://example.com/face.jpg"
    }
  }'

# Check task status; the realtime docs in the API store describe
# the SSE event stream for live session updates
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/<task_uuid>" \
  -H "Authorization: Bearer YOUR_API_KEY"

リアルタイム顔交換APIの料金は？

課金体系はNamiFusionの他の機能と同じクレジット制で、1ドル=100クレジットです。登録時にもらえる無料クレジットのおかげで、最初のセッションとAPI呼び出しは無料です。

マーケットプレイスのモデルは呼び出しごとのクレジット課金で、各カードにおおよそのドル単価が表示され、Playgroundは無料で試せます。クレジットは必要なときにチャージすればよく、強制的なサブスクリプション階層はありません。コストは利用量に比例して増えるだけなので、予算管理も簡単です。

リアルタイム顔交換APIで何が作れる？

最もわかりやすいのはライブ配信です。配信者は3Dリグやモーションキャプチャなしで別の顔として出演できます。ビデオチャットアプリにはペルソナ機能を組み込めますし、バーチャルプロダクションのチームは撮影現場でキャスト変更をリアルタイムにプレビューでき、ポスプロを待つ必要がありません。

インタラクティブな展示やライブイベントとも相性が良いです。またNamiFusionはコンテンツフィルターを設けていないため、アダルトコンテンツのクリエイターもモデレーション層と戦うことなくプロダクトを構築できます。何を作るにせよ、カメラに映る人とソース写真の本人の両方から同意を得て、合成メディアに関する現地のルールに従ってください。

デスクトップPlaygroundとAPI、どちらから始める？

まずはPlaygroundからです。コードを書かずに、自分のカメラと自分の照明環境でスワップ品質と体感遅延を数分で検証できます。開発工数を投じる前に知っておくべき答えが、まさにそこで得られます。

自社プロダクトに機能を組み込む段階になったらAPIに移行します。両者は同じエンジンで動くため、Playgroundで見た品質がそのまま本番の品質です。1つだけ繰り返し強調したいのは、APIキーは必ずサーバー側に置き、クライアントアプリに同梱しないことです。

組み込み時に避けるべき失敗は？

私が見てきた失敗する組み込みの大半は、3つのミスに行き着きます。第一に、APIキーをクライアントアプリに同梱すること。必ず自前のバックエンド経由でプロキシしてください。第二に、SSEストリームが状態をプッシュしてくれるのにポーリングすること。リクエストを浪費した挙げ句、反応はむしろ遅くなります。第三に、デスクトップ版Playgroundを飛ばしてコード上で画質問題をデバッグすること。照明やカメラの問題がAPIのバグに化けて見えてしまいます。

もう1つ。テストは自分の最高の機材ではなく、ユーザーが現実に使うであろう最低ランクのカメラと照明で行いましょう。薄暗い部屋の粗いノートPCカメラでも破綻しないスワップなら、他のどんな環境でも見栄えします。