namifusion

namifusion 画像 フェイススワップ API の使い方:顔交換統合ガイド(2026)

2 min · 更新 2026-07-11 · NamiFusion チーム

NamiFusion で namifusion 画像 フェイススワップ API を呼び出す方法:パラメータ、料金、そのまま実行できるコード例、Playground で試用可能。

namifusion 画像 フェイススワップ は NamiFusion の顔交換モデルです:NamiFusion フェイススワップモデル 1人または複数人の簡単換顔が可能。複数のmodel_styleスタイルに対応、リアルな結果かワンクリック美顔処理のどちらかを直接出力、自然で綺麗な仕上がり!NamiFusion では Playground で試してから(送信前に見積もり表示)、統一 REST API で呼び出せます(1 回あたり約 $0.150)。

TL;DR

· タスク種別:顔交換(提供:NamiFusion)

· 料金:1 回あたり約 $0.150($1 = 100 クレジット)、従量課金

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

· 調整可能パラメータ:6 個(下表参照)

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

namifusion 画像 フェイススワップ で何が作れる?

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

ミーム・エンタメ:自分や友人の顔を名シーンに合成、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/faceswap-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "source_url": "https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/marketplace/thumbnails/2026-01-27/d0328839a75f.png",
    "target_url": "https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/marketplace/thumbnails/2026-02-24/94a3eefdb397.png",
    "single_face_mode": true,
    "model_style": "realistic",
    "face_enhance": false,
    "face_mapping": []
  }
}'

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

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

source_url(ソースフェイス):必須

target_url(ターゲット面):必須

single_face_mode(片面スワップ):任意

model_style(モデルスタイル):任意、デフォルト "realistic"

face_enhance(顔の強調):任意

face_mapping(顔マッピング):任意、デフォルト []

料金はいくら?

従量課金(クレジット制)。1 回あたり約 $0.150($1 = 100 クレジット)。解像度や長さなどで変動し、Playground では送信前に正確な見積もりが表示されます。

namifusion 画像 フェイススワップ

AI画像フェイススワップ:単一人物の自動フェイススワップと複数人物の精密マッピングに対応し、顔検出と組み合わせて完全なフェイススワップワークフローを実現。

NamiFusion Image FaceSwapは、高品質なAI画像フェイススワップサービスで、ソース顔をターゲット画像に置き換えることができます。単一人物フェイススワップ(自動モード)と複数人物フェイススワップ(精密マッピングモード)の2つのモードを提供し、NamiFusion Detect Facesと組み合わせることで、顔検出からフェイススワップまでの完全なワークフローを実現できます。


主な機能

  • 単一人物フェイススワップ: single_face_modeを有効にするだけで、追加設定なしに自動的にフェイススワップが完了します。
  • 複数人物精密マッピング: face_mappingを使用して、ソース顔とターゲット顔の対応関係を正確に指定でき、1対1および多対多のマッピングに対応しています。
  • 顔補正: オプションの高度な美顔機能で、自動的に肌を滑らかにし、顔の欠点を除去して、スワップ後の顔品質を向上させます。
  • 非同期タスク: 送信後にtask_uuidを返し、ポーリングまたはWebhookで結果を取得します。

技術仕様

パラメータ詳細
モデルIDnamifusion/faceswap-image
リクエスト方式非同期POST(タスク送信 + ポーリング/Webhookで結果取得)
入力ソース顔画像URL + ターゲット画像URL
出力フェイススワップ後の画像URL
処理時間通常5〜15秒

クイックスタート

APIエンドポイント

エンドポイントメソッド説明
/api/v1/marketplace/run/namifusion/faceswap-imagePOSTフェイススワップタスクを送信
/api/v1/marketplace/run/tasks/{task_uuid}GETタスクのステータスと結果を照会

認証

リクエストヘッダーにAPIキーを含めてください:

X-API-Key: sk-your-api-key

FAQ

無料で試せますか?+

登録で無料クレジットが付与されますが、現在はアプリ内の一部の顔交換機能のみに適用されます。本モデルは従量課金です。Playground ではコードなしで試せ、送信前に正確な見積もりが表示されます。

生成物は商用利用できますか?ウォーターマークは?+

商用利用できます。NamiFusion はプラットフォームのウォーターマークを付けません。利用規約と適用法に従ってください。

コンテンツポリシーは?+

NamiFusion は無検閲エンジンで恣意的な制限はなく NSFW にも対応しますが、違法コンテンツと本人の同意のない実在人物素材は禁止です。詳細は利用規約へ。

namifusion 画像 フェイススワップ のタスクはどれくらいかかる?+

パラメータ次第で、画像は数秒〜数十秒、動画は数十秒〜数分。API は task_uuid を返すのでポーリングできます。

解像度・長さの上限は?+

上のパラメータ表を参照してください。各モデルの解像度・長さの選択肢はパラメータ説明と Playground に記載されています。