product-photo-studio

商品写真スタジオ

Picsart の gen-ai CLI がサポートする、あらゆる「商品写真を AI で変換する」ワークフローに対応する単一のスキルです。商品写真（単品の商品写真、カタログ一式、または 1 枚のアートワーク）があり、再レンダリング、再ステージング、または複数のバリエーションへの展開が必要な場合に使用します。より限定的な 6 つのスキルに代わる、6 つのモード別リファレンスを備えた統合エントリーポイントです。

入力： 1 枚以上の商品写真。出力： PDP、マーケットプレイス、広告、モックアップの出品ページ、またはキャンペーンですぐに使える、スタイル設定済み、構成済み、または複数展開されたバリエーション。

使用するタイミング

タスクに合ったモードを選択してください。ユーザーの依頼が以下のいずれかに該当する場合、このスキルを使用します。

モード	該当するフレーズ	リファレンス
bulk-restyle	「カタログのスタイル設定」、「SKU 全体で背景を統一」、「大量の商品画像を PDP 用にステージング」	references/modes/bulk-restyle.md
compose	「ライフスタイル画像の合成」、「コンテキスト内の商品」、「この商品をシーンに配置」	references/modes/compose.md
seasonal	「季節に合わせた更新」、「ホリデーカタログ」、「クリスマス／夏／ブラックフライデーのカタログ」	references/modes/seasonal.md
variants	「カラーバリエーション」、「素材のバリエーション」、「カラー展開」、「サイズ表の再レンダリング」	references/modes/variants.md
reshoot	「一括再撮影」、「カタログの再生成」、「ブランドルールに沿ったエンタープライズカタログの再レンダリング」	references/modes/reshoot.md
mockups	「商品モックアップ」、「POD モックアップ」、「Etsy／Shopify の出品用モックアップ」、「手に持った状態のレンダリング」	references/modes/mockups.md

ユーザーのタスクに動画、キャラクター、またはペルソナの生成が含まれる場合、このスキルは適していません。gen-ai-use、gen-ai-persona-creation、gen-ai-use を参照してください。

前提条件

Picsart gen-ai CLI がインストールされ、認証済みであること：

# Install (signed binary, recommended)
curl -fsSL https://picsart.com/gen-ai-cli/install.sh | bash

# Authenticate
gen-ai login
gen-ai whoami    # verify

モードごとの前提条件（画像数、ブランドファイル、マニフェスト）は、各モードのリファレンスに記載されています。一括実行の前には、必ず料金を確認してください。

gen-ai pricing --model <model> --count <N>

実行方法

1. 使用するタイミングの表を使って、ユーザーの依頼からモードを特定します。
2. 対応するモードのリファレンスを読み込みます：Read references/modes/<mode>.md。
3. 記載されている手順（ヒアリング、マニフェスト作成、生成）に従います。
4. タスクの途中でモードを切り替える場合にのみ、この SKILL.md に戻ります。

クイックリファレンス

# Single image (compose / mockups)
gen-ai generate --model <model> --image input.jpg --prompt "<prompt>"

# Batch (bulk-restyle / seasonal / variants / reshoot)
gen-ai batch --manifest manifest.json

# Estimate cost before running
gen-ai pricing --model <model> --count <N>

# Browse available models
gen-ai models

マニフェストのパターン、モデルの推奨事項、モードごとのベストプラクティスは、各モードのリファレンスに記載されています。

手順

モードにかかわらず、常に同じ一連の手順に従います。

1. ヒアリング — モード、入力の数、対象となる出力形式、ブランド上の制約、期限を確認します。
2. マニフェスト — JSON マニフェストを作成します（単発のインライン指定、またはバッチファイル）。各モードのリファレンスにテンプレートがあります。
3. 見積もり — 実行を確定する前に gen-ai pricing を実行します。合計金額をユーザーに提示します。
4. 生成 — gen-ai generate または gen-ai batch を実行します。進捗をストリーミング表示します。
5. 確認 — 出力ディレクトリを開き、想定されるファイルが期待する寸法で存在することを確認します。
6. 引き渡し — 設定済みの Drive フォルダー、マーケットプレイスのフィード、または納品用 ZIP に配置します。

注意点

「バリエーションごとに影の向きがずれる」、「季節のオーバーレイに有効期限がある」、「brand.md のゲートによって SKU-XYZ がブロックされる」といったモード固有の注意点は、各モードのリファレンスに記載されています。共通の注意点：

• 料金の見積もりを必ず行ってください。 数千 SKU にわたる一括実行では、相当な費用が発生することがあります。
• 出力は必ずクライアント／実行ごとに名前空間を分けてください。 グローバルな出力ディレクトリに書き込まないでください。どのバッチで生成されたアセットか分からなくなります。
• ブランドガバナンスを遵守してください。 ユーザーの対象範囲に enterprise-brand-governor スタイルの brand.md がある場合、マニフェストでそのファイルを参照する必要があります。
• バッチの途中でモデルを切り替えないでください。 一貫性を保つため、実行ごとにモデルのバージョンを正確に固定してください。enterprise-pinned-registry を参照してください。

検証

実行後は必ず、次を確認してください。

# Confirm output count matches expected
ls -1 outputs/<run>/ | wc -l

# Spot-check one output's dimensions
gen-ai inspect outputs/<run>/<sample>.jpg

問題がある場合は、--debug を付けて再実行し、モードリファレンスの「よくある落とし穴」セクションを参照してください。

関連項目

• gen-ai-use — gen-ai CLI の基礎リファレンス
• enterprise-brand-governor — ポリシーによる制御
• enterprise-pinned-registry — バージョンの固定