前提条件
生成前にこれらのスキルをインストールしてロードしてください(@pruna で既にコンテキスト内にある場合はスキップ):
| スキル | 説明 | インストール方法 |
|---|---|---|
generation-diversity | 生成プロンプトを作成する際に使用 — 有料API呼び出し前の儀式的シード、明示的構造、シナリオ軸、品質ゲート。 | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
video-prompting | 動画やモーションプロンプトを作成する際に使用 — ドラマツルギー、カメラ、物理安全なモーション、フレームアンカー、クリップチェーン。 | npx skills add PrunaAI/pruna-skills@video-prompting -y |
pruna-api | Pruna または Replicate へのHTTP呼び出し前に使用 — 認証情報、アップロード/ポーリング/ダウンロード、並列バッチ、エージェントの安全性。 | npx skills add PrunaAI/pruna-skills@pruna-api -y |
または、フルスイートを一度にインストール: npx skills add PrunaAI/pruna-skills@pruna -y
各スキルの 「生成前」/「クラフト」 セクションに従ってください — ここではガイド内容を再記述しません。
エージェントの習慣
最初の返信では、`p-video-edit` をバッククォートで囲んで名前を伝え、PRUNA_API_KEY を確認し(なければ pruna-api のサインアップリンクで停止)、ソース動画(最大 15秒)と編集概要を尋ねます。入力受付 → 最初の POST の前に generation-diversity による明確化の受付を行います。編集は 「動的かつ忠実な」プロンプト設計 でドラフトしてください — スキルのサンプルを貼り付けないでください。「使用すべきでない場合」に該当する場合は、適切なスキルにリダイレクトしてください。
プロンプト設計(動的かつ忠実)
prompt は 外科的 かつ リクエストに固定 します。1回の実行で1つの主要な変更のみ行います。望ましい最終状態を記述し、次に変更してはならないものを指定します。ユーザーが求めたものだけを変更し、カメラ、モーション、オーディオ、および言及されていない要素は同一に保ちます。
| するべきこと | してはいけないこと |
|---|---|
公式: Change only [X]. Preserve [geometry / motion / camera / lighting / unmentioned subjects]. | 漠然とした make it better / 新しいシーンを作り出すムードだけの書き換え |
| ユーザーからの すべての維持すべき要素(被写体、カメラパス、照明、小道具)を明示する | 維持条項を省略し、モデルがそれらを保持してくれることを期待する |
| ドラフト前に儀式的シードを行う。ブリーフが許せば維持条項を新たな言葉で表現する | ユーザーが異なる編集を説明しているのに、このスキルのサンプル(sunset sky)をコピーする |
参照画像を使用する場合: add the accessory from the first reference のように指示する | ソーススロットなしで漠然と use the reference とだけ書く |
文言が固定されていない場合、POST の前に prompt を表示する | カメラ、キャスト、または要求されていない領域を変更するサイレント編集 |
忠実性チェック(支払い前): プロンプトは、ユーザーの変更要求 かつ すべての明示された維持条件を依然として満たしている必要があります。ユーザーが1つの属性または環境編集を求めた場合に、余分な要素を「スパイス」してはいけません。
弱いジョブ(避けるか、警告するもの): 真新しいシーン/プロット; 独立した動きを持つオブジェクトの追加(特に新しい手持ち形状); カメラアングル、カメラモーション、またはズームの変更。
スキルの境界
| p-video-edit | p-video-replace | |
|---|---|---|
| ユーザーの質問 | このクリップの色/環境/オブジェクト/テキスト/照明を変更する? | この動画の中の人物を置き換える? |
| 目標 | ソースクリップ に対する指示編集 | 既存の映像 に アイデンティティを 注入 する |
| 参照画像 | 任意の images — 0~4枚 | 必須の images — 1~4枚 |
| プロンプトフィールド | prompt | instruction_prompt |
キャラクターを必須の参照スチルから置き換えるジョブの場合は、p-video-replace を使用してください。プロンプト駆動の属性、環境、オブジェクト、テキスト、または照明の編集には、このスキル を使用します。
使用すべきでない場合
代わりに別のスキルを使用してください:
| スキル | 説明 | インストール方法 |
|---|---|---|
p-video-2-pro | テキストまたは開始/終了フレームから映画的なクリップを生成する場合に使用 — 商品広告、ドキュメンタリーショット、または生成オーディオ付きのダイアログ。1080p、インポートされたオーディオトラック、またはトーキングヘッドのみのホストには使用しません。 | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | テキスト、画像、またはインポートされたオーディオから洗練された短いクリップを生成する場合に使用 — 1080p Bロール、開始/終了フレームアニメーション、ミックスされたトラック付きモーションショット。映画的な生成オーディオクリップやトーキングヘッドのみのホストには使用しません。 | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | テキストや画像からシンプルな短いクリップが必要な場合に使用 — クイックBロール、下書き、または開始/終了フレームアニメーション。映画的な生成、最高品質、タイトなリップシンク、または1080pでのインポートオーディオが必要な場合には使用しません。 | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-replace | 既存の映像内の人物、衣装、または製品を、カメラの動きとオーディオを維持したまま交換する場合に使用します。 | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-video-animate | 写真を別の動画のように動かしたい場合に使用 — モーショントランスファー、ダンスリミックス、テンプレートクリップからのパフォーマンスバリエーション。 | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
video-editing | すでにレンダリングされたクリップをffmpegで編集または仕上げる場合(結合、クロスフェード、焼き込みキャプションと字幕、テキスト/ロゴオーバーレイ、ビフォーアフタースライダー、背景音楽、プラットフォームエクスポート)またはHyperframesを使用して多層HTML合成ビデオを構成する場合に使用します。AI動画生成、プロンプト設計、モデルベースの動画編集には使用しません。 | npx skills add PrunaAI/pruna-skills@video-editing -y |
HTTP (curl)
ソース動画のアップロード
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/source-video.mp4"
レスポンスの urls.get を input.video で使用します。ソース動画の最大長: 15秒。
任意の参照画像
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/reference-image.png"
各レスポンスの urls.get を input.images で使用します(最大4枚、jpg, jpeg, png, webp)。
作成(非同期 — 推奨)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/source-video-abc123",
"prompt": "Change only the sky to a sunset. Preserve the subject, camera path, and lighting on the foreground."
}
}'
ポーリングとダウンロード: pruna-api に従ってください。出力の長さはソース動画に従います。課金は 返された 秒数あたり(標準 $0.045、ドラフト $0.025)。レート制限: 1分あたり50リクエスト。
プロンプトを作成する前に、generation-diversity のランダムシードの儀式を完了してください — 儀式の文字列をAPIの seed として渡さないでください。オプションの seed は、ユーザーが再現性を要求した場合のみ使用します。
作成(同期 — クイックテストのみ)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/source-video-abc123",
"prompt": "Change only the sky to a sunset. Preserve the subject, camera path, and lighting on the foreground.",
"draft": true
}
}'
生成前
- 前提条件ガイドの読み取り順序を完了する(
generation-diversity→video-prompting)。 - 儀式的シード → 動的かつ忠実な
prompt(上記セクション)をドラフト →video(15秒以内)、prompt、任意のimages(0~4枚)、draft、save_audio、および編集意図(属性/削除/追加/環境/再照明/テキスト/参照ガイド)を確認する。 - Pruna注意点: 1回の実行で1つの主要な変更のみ。身元や製品の一致は任意の
imagesから得られます。編集指示はpromptに記述します。曖昧なターゲットや真新しいシーンは品質を低下させます。taskフィールドを送信しないでください — これは公開APIにはありません。
必須入力
video(文字列URL): 編集するソース動画。最大長: 15秒prompt(文字列): 編集内容を説明するテキスト指示
一般的なオプションフィールド
images(最大4つの文字列URLの配列): 参照ガイド編集用の参照画像(jpg,jpeg,png,webp)prompt_upsampling(ブール値, デフォルトtrue)draft(ブール値, デフォルトfalse): より速く、低品質のプレビュー。出力秒あたり$0.025で課金save_audio(ブール値, デフォルトtrue)seed(整数): 再現可能な再実行のためにのみ設定
典型的な次のステップ
このスキルの後によく続く操作:
| スキル | 説明 | インストール方法 |
|---|---|---|
p-video-replace | 既存の映像内の人物、衣装、または製品を、カメラの動きとオーディオを維持したまま交換する場合に使用します。 | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-image-edit | 既存の写真を編集する場合に使用 — 衣装や背景の変更、参照画像からの合成、またはプロンプト駆動の編集。 | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
video-editing | すでにレンダリングされたクリップをffmpegで編集または仕上げる場合(結合、クロスフェード、焼き込みキャプションと字幕、テキスト/ロゴオーバーレイ、ビフォーアフタースライダー、背景音楽、プラットフォームエクスポート)またはHyperframesを使用して多層HTML合成ビデオを構成する場合に使用します。AI動画生成、プロンプト設計、モデルベースの動画編集には使用しません。 | npx skills add PrunaAI/pruna-skills@video-editing -y |