プロジェクト概要
「AIキャラクター置き換え動画」はClaude向けのSkillです。すでに人気のある動画内の人物を、あなたがデザインしたオリジナルAIキャラクターに置き換えながら、元動画の動きやテンポをできる限り維持することを目的としています。
このプロジェクトは、Seedance 2.5を呼び出して動画内の人物を置き換えるだけでなく、キャラクターデザイン、設定画のプロンプト、キャラクタープロファイル管理、元動画のチェック、比較動画の作成、TikTok、Instagram、X向けの投稿文生成までをカバーします。
サンプルキャラクターの「聞さん」は、明代の書生の頭部と会社員の身体を組み合わせています。大きなまげに玉かんざしを横向きに挿し、サイズの大きいスーツに白い靴下とサンダルを合わせています。この例では、元動画の人物だけを置き換え、動きはそのまま維持します。
主な機能
- オリジナルキャラクターのデザイン：「誇張した特徴は身に着けるのではなく、人の身体に現れる」という原則に基づき、キャラクター案と設定画のプロンプトを生成します。
- キャラクタープロファイルの保存：設定画、正面写真、外見の説明を保存し、後の置き換えで再利用します。キャラクターの外見のぶれを抑えられます。
- 元動画のチェック：動画の解像度と長さを自動で報告し、画素数が不足している場合は自動で拡大してプレビュー画像を生成します。
- 置き換えプロンプトの生成：1人または複数人の置き換えに対応し、
@画像の番号で関連素材を対応付けます。 - Seedance 2.5の呼び出し：BytePlus ModelArkまたは火山方舟APIを通じて、タスクの自動送信、ステータスのポーリング、結果のダウンロードを行います。
- 比較動画の作成：元動画と置き換え後の動画を左右に並べ、ラベルを追加し、黒帯を防ぎます。
- 投稿内容の準備：TikTokとInstagramのキャプション案、およびXのチュートリアルスレッド向けの文章を生成します。
プロジェクトのファイル構成
プロジェクトの主なファイルとディレクトリは次のとおりです。
skills/ai-character-swap/SKILL.md：Claudeが使用するSkill本体です。skills/ai-character-swap/scripts/seedance_swap.py：Python 3とffmpegだけに依存する付属Pythonスクリプトです。新手说明.md：コマンドラインに不慣れなユーザー向けの説明です。Web版で手順を進める方法も含まれています。examples/：プロジェクトの比較動画サンプルディレクトリです。
準備
ffmpegのインストール
プロジェクトのスクリプトでは、動画処理にffmpegを使用します。macOSユーザーはHomebrewでインストールできます。
brew install ffmpegWindowsユーザーはwingetを使用してインストールできます。
winget install ffmpegスクリプトが依存するのはPython 3とffmpegだけです。インストール後、ターミナルでこの2つのコマンドを正常に実行できることを確認してください。
Seedance 2.5 APIの有効化
Claudeに置き換えタスクの自動送信と動画のダウンロードを行わせるには、Seedance 2.5 APIを有効にしてAPI Keyを作成します。プロジェクトでは環境変数ARK_API_KEYからキーを読み込みます。
export ARK_API_KEY="あなたの_API_Key"Windows環境では、使用するターミナルに応じて環境変数を設定してください。実際のAPI Keyを公開コードに直接記述したり、リポジトリに公開したりしないでください。
方法1：Claudeに自動実行させる
- ffmpegをインストールし、Python 3環境を用意します。
- Seedance 2.5 APIを有効にしてAPI Keyを作成し、
ARK_API_KEYを設定します。 - プロジェクト内の
skills/ai-character-swap/をClaudeのSkillとして追加します。 - オリジナルキャラクターの画像と、人物を置き換えたい動画を用意します。
- 自分のPCからキャラクター画像と動画をClaudeに送り、置き換える対象を説明します。
基本的なタスクの指示は次のように書けます。
動画内の人物を「聞さん」に置き換えてください。まず動画を確認し、キャラクタープロファイルの画像と外見の説明から置き換えプロンプトを作成してください。完了したら左右比較動画を作成し、投稿文も提示してください。ClaudeはSkillの手順に従って、キャラクター資料、元動画、Seedanceタスクを処理します。動画に複数の人物がいる場合は、どの人物を置き換えるか、または複数人を一度に置き換えるかを明確に指定できます。
方法2：コードを書かずにWeb版を使う
コマンドラインやAPIに不慣れな場合は、プロジェクト内の初心者向け説明を読み、「方法1：Web版」を使用してください。この方法では、ChatGPTとSeedanceのWeb版を組み合わせてキャラクターデザインと動画の人物置き換えを行うため、プロジェクトのスクリプトを直接実行する必要がありません。
Web版はまず全体の流れを試すのに適しています。タスクの自動送信、ポーリング、ダウンロードが必要になったら、Claude SkillとSeedance 2.5 APIを組み合わせて使用してください。
一連の制作フロー
1. オリジナルキャラクターをデザインする
まず、キャラクターの核となるギャップと、視覚的に印象に残る特徴を決めます。プロジェクトでは、誇張した特徴を単に服装として追加するのではなく、キャラクターの身体と外見の一部にすることを重視しています。デザインが完成したら設定画のプロンプトを生成し、正面写真を用意します。
2. キャラクタープロファイルを作成する
設定画、正面写真、外見の説明をキャラクタープロファイルに整理します。毎回同じプロファイルを参照して置き換えることで、髪型、顔の特徴、体型、服装などの視覚情報を一貫させやすくなります。
3. 元動画をチェックする
処理する動画をClaudeまたは付属のフローに渡し、まず解像度と長さを取得します。元動画の画素数が不足している場合は、フローが自動で拡大してプレビュー画像を生成するため、素材が処理に適しているか確認できます。
4. 置き換えプロンプトを生成する
キャラクタープロファイルと動画の内容に基づいてプロンプトを生成します。素材が多い場合は、@画像の番号を使って、キャラクター画像とプロンプト内の参照画像を対応付けます。1人を置き換える場合は対象を明確にし、複数人を置き換える場合は各キャラクターに対応する画像と人物を指定します。
5. Seedance 2.5を呼び出す
APIフローでは、タスクの自動送信、生成ステータスのポーリング、タスク完了後の結果ダウンロードを行います。プロジェクトのseedance_swap.pyには、この処理に必要な機能が用意されています。具体的なリクエスト形式は、BytePlus公式のComfyUI向けSeedance 2.5接続コードをもとに整理されています。
APIを初めて使うときは、まずスクリプトの--dry-runオプションでフローとリクエストを確認し、いきなり長い動画から始めないことをおすすめします。設定に問題がないことを確認してから、短い動画で実際のテストを行ってください。
6. 比較動画を作成する
置き換え結果を確認したら、左右比較動画を生成します。左側に元動画、右側にAIによる置き換え結果を配置し、わかりやすいラベルを追加します。プロジェクトが画面レイアウトを処理し、完成動画に黒帯が出ないようにするため、そのまま効果の紹介に使用できます。
7. 投稿文を生成する
最後に、完成動画をもとにClaudeへTikTokとInstagramのキャプション案を生成させるか、Xのチュートリアルスレッド用に整理させます。投稿前に、動画でAIを使用していることが正確に説明されているか確認してください。
応用時のアドバイス
キャラクタープロファイルを優先して固定する
置き換えのたびにキャラクターを説明し直さないでください。同じ設定画、正面写真、外見の説明を継続して使用することで、動画ごとのキャラクターの不一致を抑えられます。
短い動画から長い動画へ進む
API呼び出しは、現時点では慎重に試すことをおすすめします。まず--dry-runでリクエストを確認し、短い動画でAPI Key、動画パラメータ、ダウンロードフローを検証してください。成功を確認してから本番素材を処理します。
人物と画像の対応関係を明確にする
複数人が登場する動画では、置き換える人物をプロンプトで明確に説明し、@画像の番号で正しいキャラクター素材を指定します。これにより、キャラクター画像と対象人物の取り違えを防ぎやすくなります。
動画の著作権と肖像権に注意する
プロジェクトでは、キャラクターを必ずオリジナルにする必要があります。著名人、インフルエンサー、身近な人の写真を使ってキャラクターを作成しないでください。プラットフォームによるブロックや、肖像権の問題につながる可能性があります。
投稿時にAI表示を有効にする
TikTokやInstagramに投稿する際は、プラットフォームの要件に従ってAI生成コンテンツであることを表示してください。比較動画と投稿文でも、素材がすべて実写撮影によるものだと誤解させないようにする必要があります。
プロジェクトの状況とトラブルシューティング
動画チェック、プロンプト生成、比較動画の作成は、サンプル素材でテスト済みです。API呼び出し部分のリクエスト形式はBytePlus公式の接続コードをもとに整理されているため、初回はdry runを行い、その後短い動画で検証してください。
問題が発生した場合は、ffmpegがインストールされているか、ARK_API_KEYが正しく設定されているか、動画が長すぎないか、解像度が不足していないかを確認し、プロジェクトリポジトリの説明も参照してください。それでも解決しない場合は、プロジェクトにIssueを提出できます。
まとめ
「AIキャラクター置き換え動画」は、キャラクターデザイン、キャラクターの一貫性管理、動画チェック、Seedance 2.5 APIの呼び出し、比較動画の作成、投稿文の生成を1つのClaude Skillに統合しています。まずWeb版で流れを把握することも、APIを設定して素材のチェックから完成動画の出力までをClaudeに自動実行させることもできます。
始める前に、2つの原則を守ってください。オリジナルキャラクターを使用すること、そして投稿時にAIコンテンツであることを正しく表示することです。これにより、キャラクターを安定して再利用しやすくなり、著作権、肖像権、プラットフォームのコンプライアンスに関するリスクも抑えられます。