前提条件
生成前にこれらのスキルをインストールして読み込んでください(@pruna で既にコンテキスト内にある場合はスキップ):
| スキル | 説明 | インストール |
|---|---|---|
generation-diversity | 生成プロンプトを作成する際に必ず使用 — 有料API呼び出し前に、儀式的シード、明示的な構造、シナリオ軸、品質ゲートを設定します。 | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
image-prompting | 静止画プロンプトを作成する際に必ず使用 — 構図、アイデンティティシート、編集、試着、フォトリアルなペルソナを作成します。 | npx skills add PrunaAI/pruna-skills@image-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-try-on` をバッククォートで囲んで名前を示し、PRUNA_API_KEY を確認してから、person_image + garment_images を尋ねてください。問い合わせを受け付けます → ユーザーが沈黙している場合は、generation-diversity の明確化の問い合わせを開始します。参照画像の曖昧さを解消する必要がある場合は、プロンプト作成(動的かつ忠実) を使ってドラフトを作成してください — スキルの例をそのまま貼り付けないでください。背景のみ/衣類なしのジョブは p-image-edit にリダイレクトしてください。
プロンプト作成(動的かつ忠実)
アイデンティティと衣類は person_image + garment_images[] から取得します。オプションの prompt は参照画像の曖昧さを解消するためだけに使用します — 新しい人物や服装を創作するものではありません。
| やるべきこと | やってはいけないこと |
|---|---|
最初に person_image とすべての garment_images[] URL を確定する。クリーンなフラットレイの場合は prompt を省略する | ユーザーが提供していない新しいシーン、モデル、または衣類を説明する |
参照画像が曖昧な場合:「画像1の緑のTシャツと画像2のズボン」(image-prompting の試着作成を参照) | ムードだけのプロンプト(「ファッションエディトリアルな雰囲気」)や、参照画像が異なる場合にこのスキルの拡張例をコピーする |
| 曖昧さを解消する表現をドラフトする前に儀式的シードを実行する。有効なマッピングが複数ある場合は表現を変える | 背景の切り替えに prompt を使用する — p-image-edit にリダイレクトする |
参照画像が曖昧な場合は、POST の前に prompt(必要な場合)を示す | ポーズ、顔、または指示を超えた衣類を変更するサイレント試着を行う |
忠実性チェック(支払い前): 出力は依然としてユーザーの人物がユーザーの衣類を着ているものでなければなりません。prompt が別の参照セットに適用される可能性がある場合は、曖昧さを解消する表現を書き直してください。
使用すべきでない場合
代わりに別のスキルを使用してください:
| スキル | 説明 | インストール |
|---|---|---|
p-image | 誰かが明示的に最速かつ最も安価な写真生成を希望する場合 — ムードボード、一括パネル、またはクイックイテレーション — 制御されたフォトリアルや画像内テキストが必要な場合ではありません。 | npx skills add PrunaAI/pruna-skills@p-image -y |
p-image-edit | 誰かが既存の写真を編集したい場合 — 服装や背景の変更、参照画像からの合成、またはプロンプト駆動の編集を適用する場合に使用します。 | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
料金
世代あたり(通常モードとターボモードで同じ):
- $0.015(最初の衣類)
- $0.008(追加の衣類ごと)
例:3着の場合 → $0.015 + 2 × $0.008 = $0.031。
リクエストの形状
1つの person_image、1枚あたり1つの garment_images[] エントリ(最大11個)、オプションの reference_pose。モデルは各衣類を自動的に分類します — 配列の順序は重要ではありません。混合カテゴリは 1回の呼び出しにまとめてください。
prompt— 参照画像に複数の衣類が写っているか、モデルが着用している場合のみ使用します。クリーンなフラットレイにはプロンプトは必要ありません。preserve_input_size: true(デフォルト)— 出力サイズは 人物画像に従います。
Runware フィールドマッピング:person → person_image、garment → garment_images[]、pose → reference_pose、positivePrompt → prompt、settings.turbo → turbo。
HTTP (curl)
画像のアップロード
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/person.jpg"
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/garment.png"
各レスポンスの urls.get を input.person_image と input.garment_images[] で使用します。オプション:reference_pose。
作成(非同期 — 推奨)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-image-try-on' \
-d '{
"input": {
"person_image": "https://api.pruna.ai/v1/files/PERSON_FILE_ID",
"garment_images": ["https://api.pruna.ai/v1/files/GARMENT_FILE_ID"]
}
}'
ポーリングとダウンロード:pruna-api に従ってください。
generation-diversity からランダムシードの儀式を完了してからプロンプトを書いてください — 儀式の文字列をAPIの seed として渡さないでください。
作成(同期 — クイックテストのみ)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-image-try-on' \
-H 'Try-Sync: true' \
-d '{
"input": {
"person_image": "https://api.pruna.ai/v1/files/PERSON_FILE_ID",
"garment_images": ["https://api.pruna.ai/v1/files/GARMENT_FILE_ID"]
}
}'
拡張入力(ターボ + ポーズ + プロンプト)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-image-try-on' \
-d '{
"input": {
"person_image": "https://api.pruna.ai/v1/files/PERSON_FILE_ID",
"garment_images": [
"https://api.pruna.ai/v1/files/MULTI_GARMENT_SHOT_ID",
"https://api.pruna.ai/v1/files/BOTTOM_ID"
],
"reference_pose": "https://api.pruna.ai/v1/files/POSE_REF_ID",
"prompt": "画像1の緑のTシャツと画像2のズボン",
"turbo": true,
"output_format": "jpg",
"output_quality": 95,
"preserve_input_size": true
}
}'
生成前
- 前提条件ガイドを順番に読んで完了する(
generation-diversity→image-prompting試着作成)。 - 儀式的シード → オプションの 動的かつ忠実な 曖昧さ解消
prompt(上記セクション)をドラフト →person_image、garment_images(最終版は6枚以下。7~8枚は通常成功。9~11枚だと最後のアイテムが落ちる可能性あり)、そしてオプションのturbo/reference_pose/promptを確認する。 - Pruna の注意事項: 体の1箇所につき1アイテム(靴下+靴 → 通常は靴が優先)。
turbo(約2.5~3.5秒)はデフォルトでオフ — 最終版で約4着以上の場合は推奨しません。全身または3/4身の人物クロップが最適です。手袋、ミトン、手持ち小道具、ポケットチーフ、サスペンダー、ブローチはgarment_images[]から除外してください。
必須入力
person_image(文字列URL)garment_images(文字列URLの配列、最大 11)
一般的なオプションフィールド
seed、output_format(webp/jpg/png、デフォルトjpg)、output_quality(0~100、デフォルト 95)preserve_input_size(ブール値、デフォルトtrue)turbo(ブール値、デフォルトfalse)reference_pose(人物画像URL)prompt(実験的 — 非フラットレイ / 複数衣類の参照画像の曖昧さを解消するため)
典型的な次のステップ
このスキルの後によく行われるフォローアップ:
| スキル | 説明 | インストール |
|---|---|---|
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-avatar | 誰かがカメラに向かって台本を話す人物を欲する場合 — リップシンクするホスト、スポークスパーソン、または肖像写真からナレーション付きアバターを作成します。 | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |