P-Video 2 Pro Replace 入門ガイド：1〜2枚の写真で動画内の人物を置き換える

P-Video 2 Pro Replace は Pruna AI の動画人物置き換えモデルです。ソース動画と1〜2枚の人物写真を渡すと、元動画の動き、カメラワーク、シーン、音声を保持したまま、画面内の人物を写真の人物に置き換えます。この記事では、何ができるか、どう呼び出すか、料金の計算方法、そして別のモデルを使うべきケースを説明します。

できること

• 動画1本と写真1枚で人物を置き換え：必須なのはソース動画 video_url と人物写真 image_urls のみで、事前に人物の学習を行う必要はありません。
• 最大2人まで置き換え可能：image_urls には1〜2枚の写真（jpg、jpeg、png、webp）を指定します。1人の場合は1枚、2人の場合はそれぞれ1枚ずつ指定します。
• 元動画の要素をすべて保持：動き、カメラワーク、シーン、長さはすべてソース動画に従います。keep_audio はデフォルトで有効になっており、出力には元動画の音声が含まれます。false に設定すると元音声なしで出力されます。
• 5段階の解像度：480p、768p、1080p、2k、4k。デフォルトは768pで、ソース動画のアスペクト比を維持します。
• 任意のプロンプト：prompt（最大1000文字）で写真の人物をどのように画面に配置するかを指定できます。指定しなくても生成可能です。

入力要件

• ソース動画：MP4、MOV、WebM形式で、長さは2〜30秒。範囲外の動画は送信時に拒否され、課金されません。より長い素材は事前に30秒以内のクリップに編集してください。
• 人物写真：1〜2枚、HTTPSリンク。
• コンテンツ安全フィルターはデフォルトで有効です。違反コンテンツは失敗し CONTENT_POLICY_VIOLATION が返され、料金は全額返金されます。

呼び出し方法

非同期タスクを送信し、taskId を取得してから結果をポーリングします：

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "p-video-2-pro-replace",
    "input": {
      "video_url": "https://example.com/source.mp4",
      "image_urls": ["https://example.com/person.jpg"],
      "resolution": "768p",
      "keep_audio": true
    }
  }'

curl https://api.hiapi.ai/v1/tasks/<taskId> \
  -H "Authorization: Bearer $HIAPI_KEY"

タスクが成功すると、output に動画のURLが入ります。長さはソース動画と同じです。

料金

出力動画の長さに応じて課金され、1秒未満の端数は課金されません。写真が1枚でも2枚でも料金は同じです：

• 480p：$0.0358/秒
• 768p：$0.0715/秒
• 1080p：$0.0858/秒
• 2k：$0.1000/秒
• 4k：$0.1286/秒

例えば10秒の768p動画は約$0.72、30秒の480pは約$1.07です。送信時にはまず30秒分を事前に引き落とし、完了後に実際の動画の長さで精算し、引き落とし過ぎた分は返金されます。失敗したタスクは全額返金されます。

より良く使うために

• ソース動画内の人物が鮮明で動きが滑らかであり、写真の正面の顔がはっきりしていて照明が均一だと、より安定した置き換え結果が得られます。
• まず480pの短いクリップで効果を確認し、その後高解像度で最終版を出力してください。
• 結果を固定したい場合は seed（0〜2147483647の整数）を渡します。同じ入力と組み合わせることで再現性が高まります。

別のモデルを選ぶケース

• 画面のスタイル、シーン、カメラワークを変更したい場合：このモデルは人物のみを置き換え、それ以外はソース動画に従うため、動画編集系のモデルを選択してください。
• ソース動画がなく、人物写真1枚とセリフのみの場合：同シリーズの P-Video 2 Pro Avatar を使って口頭ナレーション動画を生成してください。

すぐに効果を試したい場合は、HiAPI Playground で短い動画と人物写真をアップロードして生成できます。