ヘッドスワップ – 解析 API の使い方：character swap統合ガイド（2026）
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.100）。
TL;DR
· タスク種別：character swap（提供：NamiFusion）
· 料金：1 回あたり約 $0.100（$1 = 100 クレジット）、従量課金
· 始め方：Playground で試用（送信前に見積もり）→ API キー作成 → POST 一発で統合
· 調整可能パラメータ：1 個（下表参照）
· プラットフォーム透かしなし。商用利用可（利用規約に従う）
ヘッドスワップ – 解析 で何が作れる？
コンテンツ制作の自動化：このモデルをワークフローに組み込み、統一 API で従量課金呼び出し。
この API はどう呼び出す？
- NamiFusion に登録し、API Keys ページでキーを作成（登録特典クレジットは指定モデルのみ対象）。
- 下記の cURL 例でタスクを送信。Bearer トークンにキーを指定。
- 返された 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（解像度）：任意、デフォルト "720p"
料金はいくら？
従量課金（クレジット制）。1 回あたり約 $0.100（$1 = 100 クレジット）。解像度や長さなどで変動し、Playground では送信前に正確な見積もりが表示されます。
ヘッドスワップ – 解析
ヘッドスワップ動画ワークフローの第 1 段階として、動画内の頭部を検出・追跡します。
Head Swap Analyze は、入力動画に映る頭部をフレーム間で追跡し、次の Generate ステップに必要な obj_id と track_manifest_url を作成します。分析結果には確認用プレビューと動画情報も含まれます。このモデル単体では最終動画を生成しないため、同じ入力動画、解像度、分析結果を一組として管理してください。
主な特長
- 頭部の検出と追跡：動画内の対象を識別し、フレームをまたいだ追跡情報を作成します。
- 対象を選べるプレビュー：
objectsから各頭部のobj_id、プレビュー、マスク、カバレッジを確認できます。 - 生成用トラック情報：
track_manifest_urlを Head Swap Generate へ渡して置換処理を継続できます。 - 動画メタデータ：
video_infoに幅、高さ、FPS、フレーム数が含まれます。 - 480p / 720p 分析：生成時と同じ解像度で対象を追跡できます。
技術仕様
| 項目 | 内容 |
|---|---|
| ワークフロー | Head Swap のステップ 1 |
| 必須入力 | video_url |
| 動画の上限 | 30 秒 |
| 解像度 | 480p、720p（デフォルト） |
| 主な出力 | objects、track_manifest_url、video_info |
| 次のモデル | namifusion/head-swap/generate |
基本フロー
namifusion/head-swap/analyzeに動画 URL と解像度を送信します。- 完了までタスク結果をポーリングします。
objectsのプレビューから置き換える頭部のobj_idを選択します。- 同じ動画、返されたマニフェスト、選択した ID を Head Swap Generate へ渡します。
よくある質問
無料で試せますか？+
登録特典クレジットは指定モデルでのみ利用でき、対象範囲は随時更新されます。Playground では送信前に正確な見積もりを確認できます。
生成物は商用利用できますか？ウォーターマークは？+
商用利用できます。NamiFusion はプラットフォームのウォーターマークを付けません。利用規約と適用法に従ってください。
コンテンツポリシーは？+
ポルノコンテンツ、未成年者を性的に扱うコンテンツ、許可のない実在人物の利用、欺瞞的ななりすまし、詐欺、虚偽の推薦は禁止です。合法で、成人全員の同意があり、露骨でないテーマは認められる場合があります。詳しくは利用規約をご覧ください。
ヘッドスワップ – 解析 のタスクはどれくらいかかる？+
パラメータ次第で、画像は数秒〜数十秒、動画は数十秒〜数分。API は task_uuid を返すのでポーリングできます。
解像度・長さの上限は？+
上のパラメータ表を参照してください。各モデルの解像度・長さの選択肢はパラメータ説明と Playground に記載されています。