ヘッドスワップ – 解析 API の使い方：character swap統合ガイド（2026）

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

NamiFusion でヘッドスワップ – 解析 API を呼び出す方法：パラメータ、料金、そのまま実行できるコード例、Playground で試用可能。

ヘッドスワップ – 解析は NamiFusion のcharacter swapモデルです：Detect and track heads in a video with SAM3. Returns a head list with preview images and a track manifest for the generate step.NamiFusion では Playground で試してから（送信前に見積もり表示）、統一 REST API で呼び出せます（1 回あたり約 $0.050）。

TL;DR

· タスク種別：character swap（提供：NamiFusion）

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

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

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

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

ヘッドスワップ – 解析で何が作れる？

コンテンツ制作の自動化：このモデルをワークフローに組み込み、統一 API で従量課金呼び出し。

この 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/analyze" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "resolution": "720p"
  }
}'

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

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

resolution（Resolution）：任意、デフォルト "720p"

料金はいくら？

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