product-photo-studio

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Product Photo Studio

产品照片工作室

A single skill that covers every "transform a product photo with AI" workflow Picsart's
gen-ai
CLI supports. Use this whenever the user has product photography (single packshot, full catalog, or one artwork) and needs it re-rendered, re-staged, or fanned out into variants. Replaces six narrower skills with one entry point and six mode references.
Input: one or more product photos. Output: styled, composed, or fanned-out variants ready for PDPs, marketplaces, ads, mockup listings, or campaigns.
这是一项涵盖Picsart
gen-ai
CLI支持的所有“用AI转换产品照片”工作流的技能。当用户拥有产品照片(单个包装图、完整产品目录或单件艺术品),需要重新渲染、重新布置场景或生成多种变体时,即可使用本技能。它将六个细分技能整合为一个入口点,并提供六种模式参考。
输入: 一张或多张产品照片。输出: 经过风格化、场景合成或多变体生成的成品,可直接用于产品详情页(PDPs)、电商平台、广告、 mockup列表或营销活动。

When to Use

使用场景

Pick the mode that matches the task. If the user's request maps to any of these, this skill is the right one:
ModeTrigger phrasesReference
bulk-restyle"catalog styling", "consistent background across SKUs", "PDP-ready staging at scale"
references/modes/bulk-restyle.md
compose"lifestyle compose", "product in context", "put this product in a scene"
references/modes/compose.md
seasonal"seasonal refresh", "holiday catalog", "Christmas / summer / Black Friday catalog"
references/modes/seasonal.md
variants"color variants", "material variants", "colorway fan-out", "size chart re-render"
references/modes/variants.md
reshoot"batch reshoot", "regenerate catalog", "enterprise catalog re-render with brand rules"
references/modes/reshoot.md
mockups"product mockup", "POD mockup", "Etsy / Shopify listing mockup", "in-hand render"
references/modes/mockups.md
If the user's task involves video, characters, or persona generation, this is the wrong skill — see
motion-studio
,
gen-ai-persona-creation
,
gen-ai-use
.
选择与任务匹配的模式。如果用户的需求符合以下任意一种,本技能即为合适选择:
模式触发短语参考文档
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“产品mockup”、“按需印刷(POD)mockup”、“Etsy/Shopify列表mockup”、“手持效果渲染”
references/modes/mockups.md
如果用户的任务涉及视频、角色或人物生成,本技能并不适用——请查看
motion-studio
gen-ai-persona-creation
gen-ai-use

Prerequisites

前置条件

Picsart
gen-ai
CLI installed and authenticated:
bash
undefined
已安装并完成Picsart
gen-ai
CLI的身份验证:
bash
undefined

Install (signed binary, recommended)

安装(签名二进制文件,推荐方式)

Authenticate

身份验证

gen-ai login gen-ai whoami # verify

Per-mode prerequisites (image counts, brand files, manifests) are documented inside each mode reference. Always confirm pricing before a bulk run:

```bash
gen-ai pricing --model <model> --count <N>
gen-ai login gen-ai whoami # 验证登录状态

各模式的前置条件(图像数量、品牌文件、清单)均记录在对应模式的参考文档中。批量运行前务必确认定价:

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

How to Run

操作步骤

  1. Identify the mode from the user's request using the table in When to Use.
  2. Load the corresponding mode reference:
    Read
    references/modes/<mode>.md
    .
  3. Follow the procedure described there — interview, manifest, generate.
  4. Return to this SKILL.md only when switching modes mid-task.
  1. 根据使用场景中的表格,从用户需求中识别对应的模式。
  2. 加载对应的模式参考文档:阅读
    references/modes/<mode>.md
  3. 按照文档中的流程执行——需求确认、创建清单、生成图像。
  4. 仅当任务中途切换模式时,才返回本SKILL.md文档。

Quick Reference

快速参考

bash
undefined
bash
undefined

Single image (compose / mockups)

单张图像(compose / mockups模式)

gen-ai generate --model <model> --image input.jpg --prompt "<prompt>"
gen-ai generate --model <model> --image input.jpg --prompt "<prompt>"

Batch (bulk-restyle / seasonal / variants / reshoot)

批量处理(bulk-restyle / seasonal / variants / reshoot模式)

gen-ai batch --manifest manifest.json
gen-ai batch --manifest manifest.json

Estimate cost before running

运行前估算成本

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

Browse available models

浏览可用模型

gen-ai models

Manifest patterns, model recommendations, and per-mode best practices live in the individual mode references.
gen-ai models

清单模板、模型推荐及各模式最佳实践均记录在对应的模式参考文档中。

Procedure

通用流程

Always follow the same outer loop regardless of mode:
  1. Interview — confirm: which mode, how many inputs, target output format(s), brand constraints, deadline.
  2. Manifest — assemble a JSON manifest (single-shot inline, or batch file). Each mode reference has a template.
  3. Estimate — run
    gen-ai pricing
    before committing. Surface the total to the user.
  4. Generate — invoke
    gen-ai generate
    or
    gen-ai batch
    . Stream progress.
  5. Verify — open the output directory and confirm the expected files exist with the expected dimensions.
  6. Hand off — drop into the configured Drive folder, marketplace feed, or deliverable zip.
无论使用哪种模式,均需遵循以下通用流程:
  1. 需求确认 —— 确认:使用哪种模式、输入图像数量、目标输出格式、品牌约束、交付期限。
  2. 创建清单 —— 组装JSON清单(单次任务可直接内联,批量任务需创建文件)。各模式参考文档均提供模板。
  3. 成本估算 —— 在执行前运行
    gen-ai pricing
    ,并将总成本告知用户。
  4. 生成图像 —— 调用
    gen-ai generate
    gen-ai batch
    ,实时反馈进度。
  5. 结果验证 —— 打开输出目录,确认预期文件已生成且尺寸符合要求。
  6. 交付成果 —— 将成果上传至指定的云端硬盘文件夹、电商平台数据源或打包为压缩文件交付。

Pitfalls

注意事项

Mode-specific pitfalls (e.g. "shadow direction drifts across variants", "seasonal overlays expire", "brand.md gate blocks SKU-XYZ") live inside each mode reference. Shared pitfalls:
  • Never skip the pricing estimate. Bulk runs across thousands of SKUs can rack up real cost.
  • Always namespace outputs by client/run — don't write into a global output dir, you'll lose track of which batch produced which assets.
  • Respect brand governance. If the user has an
    enterprise-brand-governor
    -style brand.md in scope, the manifest must reference it.
  • Don't switch models mid-batch. Pin the exact model version per run for consistency; see
    enterprise-pinned-registry
    .
各模式特有的注意事项(如“变体图像阴影方向不一致”、“季节性叠加素材过期”、“brand.md规则阻止SKU-XYZ生成”)均记录在对应模式的参考文档中。通用注意事项:
  • 切勿跳过成本估算。针对数千个SKU的批量运行可能产生高额费用。
  • 务必按客户/任务命名输出文件 —— 不要写入全局输出目录,否则会难以区分不同批次生成的资产。
  • 遵循品牌管理规则。如果用户使用
    enterprise-brand-governor
    类型的brand.md规则文件,清单中必须引用该文件。
  • 批量任务中途不要切换模型。为保证一致性,单次运行需固定使用特定版本的模型;详情请查看
    enterprise-pinned-registry

Verification

结果验证

After any run:
bash
undefined
运行完成后执行以下操作:
bash
undefined

Confirm output count matches expected

确认输出文件数量与预期一致

ls -1 outputs/<run>/ | wc -l
ls -1 outputs/<run>/ | wc -l

Spot-check one output's dimensions

抽查一张输出图像的尺寸

gen-ai inspect outputs/<run>/<sample>.jpg

If anything looks off, re-run with `--debug` and consult the mode reference's "Common pitfalls" section.
gen-ai inspect outputs/<run>/<sample>.jpg

如果结果不符合预期,添加`--debug`参数重新运行,并参考模式参考文档中的“常见问题”部分。

See also

相关链接

  • motion-studio
    — video pipeline (out of scope here)
  • gen-ai-use
    — foundational gen-ai CLI reference
  • enterprise-brand-governor
    — policy gating
  • enterprise-pinned-registry
    — version pinning
  • motion-studio
    —— 视频处理流程(本技能不涵盖)
  • gen-ai-use
    —— gen-ai CLI基础参考文档
  • enterprise-brand-governor
    —— 品牌规则管控
  • enterprise-pinned-registry
    —— 模型版本固定