前提条件
生成前にこれらのスキルをインストールして読み込んでください(@pruna で既にコンテキスト内にある場合はスキップ)。
| スキル | 説明 | インストール |
|---|---|---|
generation-diversity | 生成プロンプトを作成する際に使用 — 有料API呼び出しの前に、定型的なシード、明示的な構造、シナリオ軸、品質ゲートを設定します。 | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
image-prompting | 静止画像のプロンプトを作成する際に使用 — 構図、アイデンティティシート、編集、試着、フォトリアルなペルソナ。 | npx skills add PrunaAI/pruna-skills@image-prompting -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-image-edit をバッククォートで囲んで名前を挙げ、PRUNA_API_KEY を確認し、元の写真(と編集の概要)を尋ねてください。必要に応じて、インテーク → generation-diversity の明確化インテークを開きます。プロンプト作成(動的かつ忠実) に従って編集案を作成します。ジョブが商品画像からの衣服のフィッティングである場合は、p-image-try-on にリダイレクトします。
プロンプト作成(動的かつ忠実)
編集プロンプトは 外科的 かつ リクエストにロック されています。ユーザーが依頼したものだけを変更し、それ以外はすべて同一に保ちます。多様性は変更の 表現方法 に適用され — 新しいシーンをでっち上げるためではありません。
| 実施 | 非実施 |
|---|---|
公式:[特定のもの]を変更。 [アイデンティティ/ポーズ/照明/背景] は同一に保持。(image-prompting 編集技法) | もっと良くして / 依頼を無視したムードだけの書き換え |
| ユーザーから指定された 保持すべきもの(顔、服装、ポーズ、背景、商品)をすべて明記する | 保持節を省略し、モデルがそれらを保持してくれると期待する |
プロンプト作成前に generation-diversity から新しい儀式シードを生成し、依頼が許す範囲で(素材、色コード、カメラのニュアンスなどの)自由な表現を変える | ユーザーが別のものを依頼した場合に、このスキルのサンプル(ソフトグラデーション)をコピーする |
合成時に参照画像を指定:画像1から顔、画像2から服装 | あいまいな これらの画像を組み合わせて |
文言が確定していない場合、POST の前に編集プロンプトを表示する | 被写体、種、年齢、または依頼されていない領域を変更するサイレント編集 |
忠実度チェック(支払い前): プロンプトはユーザーの変更要求 と 指定されたすべての保持条件を満たしている必要があります。保持条件が欠けている場合は追加してください。背景のみの入れ替えを依頼された場合に、背景/キャストを「盛らない」でください。
使用すべきでない場合
代わりに別のスキルを使用してください:
| スキル | 説明 | インストール |
|---|---|---|
p-image | ユーザーが明示的に最速かつ最も安価な画像生成を求める場合 — ムードボード、一括パネル、または迅速な反復 — ただし、制御されたフォトリアルや画像内テキストが必要な場合を除く。 | npx skills add PrunaAI/pruna-skills@p-image -y |
p-image-try-on | ユーザーがバーチャル試着を希望する場合 — ファッションやeコマースのために、参照写真から人物に衣服を着せる。 | npx skills add PrunaAI/pruna-skills@p-image-try-on -y |
p-image-upscale | ユーザーが既存の画像を印刷、大きなトリミング、または高品質な出力のためにアップスケールまたはシャープにする場合。 | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
HTTP (curl)
参照画像のアップロード
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/reference.png"
各レスポンスの urls.get を input.images で使用します。
作成(非同期 — 推奨)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-image-edit' \
-d '{
"input": {
"prompt": "背景をソフトグラデーションに変更、被写体は同一に保持",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
ポーリングとダウンロードは pruna-api に従ってください。
プロンプトを作成する前に 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-image-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"prompt": "背景をソフトグラデーションに変更、被写体は同一に保持",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
編集フロー
generation-diversity の 静止画像プロンプトフロー(編集セクション) に従ってください:
- 変更と保持のロック — ユーザーの外科的な要求。プロンプト作成(動的かつ忠実) の公式に従います。
- 参照画像のアップロード —
POST /v1/files;urls.get→input.images(1~5)。ファイルURLをでっち上げないでください。 - 儀式シード → 編集プロンプトの作成(
image-prompting編集技法) → 忠実度チェック(すべての保持節が存在すること)。 - 確認 —
prompt、参照画像、aspect_ratio、turbo(難しい編集ではオフ)。 - POST — 以下の非同期curl;アップスケール/動画の前にチェックリストを確認。
アスペクト比: 編集では match_input_image を推奨。出力は元のプレートアスペクトを維持する必要があります — ずれが生じた場合は、同じ参照URLと明示的な保持節を使用して再試行してください。
Pruna 注意: アバターパイプライン — ロックされた アップスケール済み のヒーローURLから編集します。p-video* の前に再度アップスケールしてください — 動画モデルに生の編集URLを渡さないでください。
編集しない場合: ゼロから新しい被写体を作成 → p-image。商品画像からの衣服のフィッティング → p-image-try-on。
マルチ参照(最大5つ): 役割ごとに参照画像にインデックスを付けます — 例:3つの参照画像の合成:画像1から顔、画像2から服装、画像3からカフェ;難しい合成の場合は turbo: false。完全なパターンは image-prompting の p-image-edit-prompting にあります。
必須入力
prompt(文字列)images(1~5個のURLの配列、通常はhttps://api.pruna.ai/v1/files/{id})
一般的なオプションフィールド
aspect_ratio:match_input_image、1:1、16:9、9:16など。turbo(ブール値、デフォルトは true。難しい編集ではオフにする)seed、disable_safety_checker
典型的な次のステップ
このスキルの後に一般的に行われるフォローアップ:
| スキル | 説明 | インストール |
|---|---|---|
p-image-upscale | ユーザーが既存の画像を印刷、大きなトリミング、または高品質な出力のためにアップスケールまたはシャープにする場合。 | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
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-edit | ユーザーがテキスト指示で既存の動画を編集したい場合 — 色変え、スタイル変更、オブジェクトの削除または追加、環境や照明の変更、画面上のテキストの更新、またはオプションの参照画像による商品およびアクセサリーの編集。ゼロからの新しいクリップやffmpegアセンブリには使用しません。 | npx skills add PrunaAI/pruna-skills@p-video-edit -y |
p-video-avatar | ユーザーがカメラに向かって台本を話す人物を希望する場合 — ポートレート写真からリップシンクされたホスト、スポークスパーソン、またはナレーション付きアバター。 | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |
avatar-multi-scene | ユーザーが同じ人物が複数のクリップをホストすることを希望する場合 — マルチセグメントUGC、比較リール、または継続性のある混合スピーチおよびアニメーションシーン。 | npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y |
narrated-multi-scene | ユーザーがナレーション付きのマルチパートストーリーを希望する場合 — エピソード式Bロール、チャプター化されたプロモーション、またはカメラ上のダイアログなしでリンクされた動画シーン。 | npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y |
visual-transition-reel | ユーザーがショット間のトランジション付きモンタージュを希望する場合 — アクションシーケンスリールまたはナレーションがオプションのマルチシーン作品。 | npx skills add PrunaAI/pruna-skills@visual-transition-reel -y |