キャラクター置換 – 解析 API の使い方：character swap統合ガイド（2026）
NamiFusion で キャラクター置換 – 解析 API を呼び出す方法：パラメータ、料金、そのまま実行できるコード例、Playground で試用可能。
キャラクター置換 – 解析 は NamiFusion のcharacter swapモデルです：Detect and track every person in a video with SAM3. Returns a character 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/character-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 段階として、動画内の人物を検出し、追跡情報を作成します。
Character Swap Analyze は、入力動画に登場する人物をフレーム間で検出・追跡し、次の Generate ステップで使用する obj_id と track_manifest_url を返します。この段階では動画そのものを置き換えません。生成時に同じ動画と同じ解像度を使用できるよう、分析結果と入力条件をまとめて保持してください。
主な特長
- 人物の検出と追跡：動画内の人物を識別し、時間方向に対応するオブジェクト情報を作成します。
- プレビュー付きオブジェクト一覧：
objectsから各人物のobj_id、プレビュー、マスク、カバレッジを確認できます。 - 生成用マニフェスト：
track_manifest_urlを返し、Character Swap Generate へそのまま引き渡せます。 - 動画メタデータ：幅、高さ、FPS、フレーム数などの
video_infoを取得できます。 - 480p / 720p 分析：生成ステップと一致する解像度を選択できます。
技術仕様
| 項目 | 内容 |
|---|---|
| ワークフロー | Character Swap のステップ 1 |
| 必須入力 | video_url |
| 動画の上限 | 30 秒 |
| 解像度 | 480p、720p（デフォルト） |
| 主な出力 | objects、track_manifest_url、video_info |
| 次のモデル | namifusion/character-swap/generate |
基本フロー
namifusion/character-swap/analyzeに動画 URL と解像度を送信します。- タスクが完了するまで結果エンドポイントをポーリングします。
objectsのプレビューを確認し、置換する人物のobj_idを選びます。- 同じ
video_url、返されたtrack_manifest_url、選択したobj_idを Generate ステップへ渡します。
よくある質問
無料で試せますか？+
登録特典クレジットは指定モデルでのみ利用でき、対象範囲は随時更新されます。Playground では送信前に正確な見積もりを確認できます。
生成物は商用利用できますか？ウォーターマークは？+
商用利用できます。NamiFusion はプラットフォームのウォーターマークを付けません。利用規約と適用法に従ってください。
コンテンツポリシーは？+
ポルノコンテンツ、未成年者を性的に扱うコンテンツ、許可のない実在人物の利用、欺瞞的ななりすまし、詐欺、虚偽の推薦は禁止です。合法で、成人全員の同意があり、露骨でないテーマは認められる場合があります。詳しくは利用規約をご覧ください。
キャラクター置換 – 解析 のタスクはどれくらいかかる？+
パラメータ次第で、画像は数秒〜数十秒、動画は数十秒〜数分。API は task_uuid を返すのでポーリングできます。
解像度・長さの上限は？+
上のパラメータ表を参照してください。各モデルの解像度・長さの選択肢はパラメータ説明と Playground に記載されています。