ヘッドスワップ（画像） API の使い方：画像から画像生成統合ガイド（2026）

ヘッドスワップ（画像） は NamiFusion の画像から画像生成モデルです：Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.NamiFusion では Playground で試してから（送信前に見積もり表示）、統一 REST API で呼び出せます（1 回あたり約 $0.220）。

TL;DR

· タスク種別：画像から画像生成（提供：NamiFusion）

· 料金：1 回あたり約 $0.220（$1 = 100 クレジット）、従量課金

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

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

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

ヘッドスワップ（画像） で何が作れる？

SNS 用ビジュアルやカバー画像：テーマに沿って一括生成し、そのまま投稿予約。

EC・広告素材：商品シーン、バナー背景、A/B テスト用の複数バリエーション。

コンセプトアートと発想出し：キャラクター・背景・スタイルボードを低コストで高速に反復。

ワークフロー連携：生成結果をそのまま画像→動画や顔交換の入力素材に。

この 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/head-swap/image-edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "images": [
      "https://assets-public.namifusion.com/uploads/images/2026-04-21/76c1186af77d.png",
      "https://assets-public.namifusion.com/uploads/images/2026-04-21/149467630166.png"
    ]
  }
}'

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

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

images（入力画像）：必須

料金はいくら？

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