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

AI 画像フェイススワップ v5：超高速な顔・スマートヘッドスワップ、内蔵スキントーンマッチングで大量処理・本番環境に対応。

NamiFusion Faceswap v5 は、スピードとスケールを重視した画像フェイススワップ API です。Faceswap v2 と同等の推論速度を維持しながら出力品質を大幅に向上させ、自動スマートヘッドスワップ・内蔵スキントーンマッチング・クリエイティブプロンプトサポートを備えています。NamiFusion フェイススワップシリーズの中で最もコスト効率の高い選択肢です。

主な特徴

• 超高速推論： Faceswap v2 と同等のスピードを維持しながら、出力品質を大幅に改善。
• スマートヘッドスワップ： 顔のみの合成か頭部全体の合成かを自動判断し、最も自然な結果を生成——手動でのモード選択は不要。
• 内蔵スキントーンマッチング： スキントーンを自動調整し、手動補正なしで自然でシームレスな結果を実現。
• クリエイティブプロンプトサポート： additional_prompt を使用して「帽子をかぶっている」「笑顔」などの細かな属性変化を誘導。
• 再現可能な出力： シードベースの生成により、実行間で一貫した結果を保証。A/B テストやバッチワークフローに最適。
• コスト最適化： プロフェッショナルレベルの品質を犠牲にせず、NamiFusion シリーズで最も手頃なフェイススワップオプション。

技術仕様

クイックスタート

API エンドポイント

Faceswap v5 は同期レスポンスモデルを採用しています——結果はレスポンスボディに直接返され、ポーリングは不要です。

リクエストパラメータ概要

リクエストボディの Faceswap v5 コアフィールドは以下の通りです：

{
  "source_image": "string（URL）",
  "target_image": "string（URL）",
  "additional_prompt": "string",
  "image_format": "png | jpeg | webp",
  "quality": 95,
  "seed": 8005332
}

認証

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

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

標準的な呼び出しフロー

Faceswap v5 は同期ワークフローを採用しており、結果画像が直接返されます：

1. 入力パラメータを指定して POST /api/v1/marketplace/run/namifusion/faceswap-v5 を呼び出す。
2. レスポンスに結果画像が直接含まれる。
3. ポーリングのステップは不要。

タスクの送信と結果の取得

curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/namifusion/faceswap-v5" \
  -H "X-API-Key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "source_image": "https://example.com/source.jpg",
      "target_image": "https://example.com/target.jpg",
      "image_format": "png",
      "quality": 95,
      "seed": 8005332
    }
  }'

成功レスポンスの例：

{
  "status": "completed",
  "output": {
    "image_url": "https://cdn.namifusion.com/result/faceswap_v5_abc123.png"
  }
}

失敗レスポンスの例：

{
  "status": "failed",
  "output": null,
  "error_message": "Face swap failed because no valid face was detected in source_image."
}