PictMagic / 使用文档

远程 MCP

从选平台、准备商品图到写提示词,学习通过 MCP 生成和调整电商图片。

在支持远程 HTTP MCP 和浏览器 OAuth 的客户端中添加 https://pictmagic.com/api/mcp。首次使用会打开 PictMagic 登录及授权页面, 请核对客户端名称和申请权限后连接。无需安装本地程序或提供供应商密钥。

账号与连接

所有账号都可以连接、查询余额和查看能力说明。MCP 上传和生图需要付费套餐, 沿用网站现有积分、每日图片限额、存储容量、分辨率权限和水印规则。

连续 14 天没有主动调用工具,连接会过期,需要从客户端重新登录授权。 后台轮询与令牌自动刷新不续期;网站登录与 MCP 授权分别管理。 在账号菜单的 MCP 页面可以查看或立即断开连接。 断开连接不会取消供应商已经接受的生成任务。

上传与生图

  1. 先让客户端查询余额,获取支持的平台和尺寸。
  2. 创建上传链接,在同一账号下打开上传;也可以导入公开可访问的 HTTPS 图片地址。 远程 MCP 无法直接读取电脑上的文件路径。
  3. 上传真实商品图,可添加商品、风格或布局参考。分别指定每张输出的平台、用途和提示词。 多张结果可以共同参考同一组图,也可以分别使用不同商品的图片。
  4. 请求报价,打开网页确认链接,检查输入缩略图、完整提示词、数量及具体积分。
  5. 网页确认后回到客户端提交,查询进度并下载结果。图片也会进入账号图库。

报价 10 分钟有效,网页确认后需在 5 分钟内且报价到期前提交。 确认本身不开始生图。提示词、参考图、数量、尺寸或价格改变后需要重新报价确认。 仅在对话中回复“确认”不能代替网页确认。

第一次使用:复制这段话

连接后,可以直接把下面的话发给 AI 客户端。先用一张商品图生成一张结果, 核对商品细节后,再扩展到多图和多个平台。

请使用 PictMagic MCP:
1. 查询我的余额、可用平台和尺寸。
2. 创建上传链接,我会在网页上传真实商品图。
3. 上传后列出文件名和资产 ID,先和我核对哪张是主商品图。
4. 为这个商品制作 1 张 Amazon 白底主图,主体完整、突出商品,
   保持外形、颜色、按钮和标识,不添加未确认的配件或文字。
5. 获取报价,把输入图、平台、用途、尺寸、完整提示词和积分告诉我,
   给我网页确认链接;在网页确认前不要提交生图。
6. 我在网页确认后,再提交同一份报价,查询结果并给我下载链接。

如果客户端不能直接发送附件给 MCP,让它创建上传链接。把电脑路径或聊天附件发给 AI, 不代表图片已经进入 PictMagic;以上传查询返回的资产 ID 为准。

如何选择平台、用途和尺寸

平台决定要为哪个店铺准备图片;用途决定这张图要解决什么问题。 “上传的主商品图”是身份来源,“生成主图”是输出用途,两者不是一回事。

你想要的图片用途指令要点
商品主图main商品完整、主体突出,明确背景和是否展示已确认配件
使用场景图lifestyle描述真实使用地点、摆放方式和氛围,不编造功能
材质或工艺特写detail指定原图能看见的部位,不补造看不清的结构
商品与配件平铺flat-lay列出已确认包含的物品,说明俯拍与排列方式
创意广告视觉creative描述创意和留白位置,同时约束商品结构不变

先调用 list_capabilities 获取当前支持项。常见平台参数为 amazon、shopee、 taobao、tiktok、etsy、ozon。不要让客户端猜平台 ID 或尺寸。 平台预设目前为 Amazon、Shopee、淘宝等优先匹配 1:1,TikTok 为 9:16, Etsy 为 4:3,Ozon 为 3:4。这是 PictMagic 的默认构图选择,不是对平台全部规则的说明。

想从 Amazon 改做 TikTok,可以这样说:

沿用这件商品的原图,把平台改为 tiktok、用途改为 lifestyle。
从当前支持的尺寸中选择 9:16 竖图,把商品放在真实厨房台面,
主体清楚,顶部留白,不加文字,不改变商品结构。先重新报价。

改平台时还要重新考虑用途和画幅。若沿用明确指定的正方形尺寸,切换平台不会自动把它变成竖图。 更大的尺寸、不同用途或文字语言,都应在报价前说清楚,以当前可用能力和报价为准。 MCP 的平台参数用于生图,不会自动发布到店铺。

Amazon 白底主图与使用场景图要分开。 当前 amazon + main 会加入纯白背景、 突出商品、不添加装饰食物、促销徽章或无关道具的要求。如果想用食物展示真空泵用途, 另做一张 lifestyle 图片;不要把装饰食物当作随商品出售的内容。发布前仍需核对对应站点和类目要求。

用什么商品图和参考图

图片角色用什么图要告诉 AI 什么
主商品图当前实际出售型号的清晰实拍,完整展示主体,避免裁掉关键部位“这张决定商品身份,外形和结构以它为准”
商品参考 product同一型号的背面、侧面、按钮或材质细节“补充可见结构,不是另一个要合并的商品”
风格参考 style喜欢的布光、色调、背景或摄影氛围“只借鉴光线和色调,不复制参考商品、品牌或文字”
布局参考 layout希望采用的主体位置、大小关系和留白“只参考布局,商品身份仍来自主商品图”

商品图应能分辨颜色、边缘、按钮和标识;上传前处理明显模糊、遮挡和无关拼图。 优先使用自己有权使用的原图,避免把店铺截图、聊天截图或带大段文案的海报当作唯一商品来源。 没有干净原图时,明确指出截图里的目标商品及需要忽略的界面和文字。

例如准备三张图:machine-front.jpg 是主商品图,machine-side.jpg 是同型号侧面, layout.jpg 只提供构图。上传后让客户端先列出“文件名 → 资产 ID → 角色”, 确认后再创建报价。每个输出都要指定自己的主商品图;同一输出中不要重复引用同一资产。

参考图不是越多越好。只加入能补充信息的图片,发现型号、颜色或配件互相矛盾时先移除或澄清。 图片中的规格、尺寸和包装数量不会自动成为已确认事实;看不清的内容应补拍或另行说明。

提示词怎么写

按“平台和用途 → 商品身份 → 构图 → 背景与光线 → 必须保留 → 不要添加”的顺序描述。 用具体位置和可见特征代替“高级一点”“更好看”。一张图先完成一个目标。

下面是白底主图的提示词示例。按钮、颜色等细节要替换成你自己的商品事实:

Amazon 商品主图,使用主商品图中的白色手持真空泵。
完整展示机身和棕色提带,主体居中并占据主要画面,四周保留少量边距。
纯白背景,柔和均匀光线,不要投影或发光特效。
保持原图中的黑色面板、两个圆形按钮、显示屏,以及橙色与透明底部结构。
只展示主商品;不添加食物、文字、徽章、数据、额外按钮或未确认配件。

如果有布局参考,再补充:

第二张图仅用于参考主体位置和留白,不要复制它的旧型号机器。
商品身份和结构以第一张图为准。忽略参考图中的红色圈线和说明文字。

需要图片中的文字时,明确语言和准确文案;不要让 AI 自行编写未经确认的卖点。 不需要文字时直接写“不要任何文字”。不要把吸力、续航、容量、认证或“保鲜延长几倍”等 没有依据的数据写入提示词。报价页会展示加入模板要求后的完整生图提示词, 确认前检查它是否和你的目标一致;不一致就调整并重新报价。

多图共同参考和逐项生成

多张输入可以共同指导一张输出;多张输出则是多个独立的生成项。 在同一报价中写明每项的商品、平台、用途、尺寸和提示词,避免一句“做一套”造成歧义。

同一商品做三张配套图:

请为同一台机器规划 3 个输出项,先给我报价,不直接生图:
1. amazon / main:只参考正面与侧面商品图,纯白背景,只展示机器。
2. amazon / lifestyle:商品图确定机器身份;厨房图只作风格参考,
   展示机器放在厨房台面上的场景,不添加性能文字。
3. shopee / detail:使用商品图,突出原图可见的按钮和透明底部材质,
   不改变结构,不编造尺寸。
分别列出每项用到的图片、提示词和积分,再给我网页确认链接。

多个商品分别生成:

A-front.jpg 是商品 A,B-front.jpg 是商品 B,不要把两件商品混为一个型号。
分别为 A 和 B 做 1 张 shopee 主图,白底、完整展示商品。
两项各用自己的主商品图,可共同使用 light-style.jpg 作为光线参考。
先核对文件名与角色,再给出逐项报价。

先生成一张确认方向,可以避免把同一种构图问题重复到整批图片。 共同参考生成多张时,每张仍单独计费;不要把输入图数量误认为输出数量。

如何修改结果、控制费用

先检查商品外形、颜色、按钮、标识、配件和构图,再决定修改什么。 每轮集中修改一两个问题,把已满意的部分也说清楚:

沿用原始商品图,把上一张结果作为布局参考。
这次只调整构图目标:主体更大,提带和底部不能裁切;去掉背景阴影。
保持已满意的朝向和留白,不更换型号,不增加配件。
请先列出新的输入角色和完整提示词,重新报价,等待网页确认。

让客户端通过 import_images 导入上一张结果的公开 HTTPS 链接后,才能获得可引用的资产 ID; 结果链接、任务 ID 本身不是图片资产 ID。需要保持商品身份时,仍以原始商品图作为主商品图。 这种修改会重新生成整张图,不能保证其他区域像素不变;要求精确不变的标识或局部细节, 应另用能精确编辑像素的工具处理。

“成功但不满意”属于一次新的付费生成,不是失败退款或免费重试。 明确失败才使用 quote_retry 并重新报价确认;已经接受或待核实的任务先查进度, 不要因等待时间长而再次提交。检查报价页的输出数量和总积分,确认是你愿意支付的本次任务。

限制和扣费

  • 每份方案最多 10 张不同输入图,支持 PNG、JPEG、WebP;每张不超过 4MiB, 总计不超过 20MiB,不支持动画图片。
  • 每次报价最多输出 10 张,每个账号最多同时执行 2 张;仍受套餐每日限额和尺寸权限限制。
  • 上传链接 15 分钟有效;未提交的图片资产可用 24 小时,正式提交的来源图随任务保留。
  • 上传、报价、查余额和查进度不消耗生图积分。执行时逐张预扣,成功交付后结算, 明确失败的图片释放预扣。
  • 供应商响应中断或是否接受不明确时,任务标记为待核实,保留预扣额度。 请联系客服核实交付或释放额度,不要重复提交。
  • 报价不冻结整批余额,其他消费可能使后续项目暂停。停止任务会阻止未提交的图片, 已接受的图片仍可能完成并扣费。暂停后可为待执行图片重新报价确认,再继续队列。
  • 失败重试需要手动发起、新报价和网页确认。供应商是否接受尚不明确的任务不能直接重试。

平台预设用于指导构图和尺寸,不保证通过平台审核;AI 也不能保证像素级保留商品细节。 发布前请逐张核对商品结构、配件、标识和图片内容。

常见问题

需要重连: 在客户端重新授权。需要付费套餐: 升级后再上传或生图。 报价过期或价格变化: 重新报价。资产不可用: 重新上传。 积分不足: 查询账号余额。已经接受的任务请按任务 ID 查进度,不要重复提交。

先预览并优化提示词

调用 preview_prompt({output: ...}) 可免费预览,不提交任务或扣生图积分。output 与报价输出项格式相同,可增加 requirements:operation(create、replace、repair、layout、lighting)、target、preserve、composition、background、shadow(unspecified、none、contact、natural)及 avoid。

例如替换机器时,保留商品原图为 primaryAssetId,把上一张结果上传为 references 中的 {assetId: "旧结果资产ID", role: "base"},设置 operation: "replace"、target: "左侧机器"、preserve: "右侧直立袋子及食品布局"、shadow: "none"。基础图不能代替最新商品身份来源。

检查返回 issues 与 canProceed;先解决阻断项,再将相同输出项用于 quote_generation,继续网页确认。每次新报价需显式带上仍有效的要求,MCP 不会自动记住上次报价。当前渠道仍为整图重绘,不保证未修改区域像素不变;系统不会自动付费修复。

本页目录