Gamma批量替换图片：多图一键更新操作方法

在Gamma里做PPT，最怕什么？就是幻灯片做到一半，甲方突然说“所有配图换成新版的”。一页页点开、删除、上传、调位置……几十页下来，手都能点抽筋。但Gamma其实原生支持批量替换图片，用对方法，几秒钟就能搞定。

确认可批量替换的前提条件

Gamma只认“绑了块”的图片。什么意思呢？就是你通过页面上那个“+”号添加的Image Block、Cover Image，或者图文混排里的图片容器，这些才算数。如果你只是直接把PNG或者JPG图拖进编辑区，那它就是个“自由身”，不在批量替换的名单里。

怎么判断？点一下图片，看右侧属性栏有没有出现“Replace image”这个按钮。没有的话，说明它是自由粘贴的位图。处理起来也简单：删掉它，然后用“+ Insert → Image”重新插入一次，给它“上个户口”。

用“替换图像”功能批量更新同名占位图

这个方法最实用，前提是你用的图片名字得一样。比如所有页面的图片都叫“product_shot_v1”，Gamma会自动匹配并替换。

第一步：点左侧导航栏的“Assets”，切换到“Images”标签页。

第二步：找到你准备好的新图片。鼠标悬停上去，点右上角的“⋯”，选择“Rename”。把新图片的文件名改成和旧图一模一样——连大小写和扩展名都得一致。比如原图叫“banner_home.png”，那新图也得叫“banner_home.png”，不能是“Banner_Home.JPG”。

第三步：点新图片右侧那个“Replace all instances”按钮。操作其实很简单，把文件拖进去就行。Gamma会在0.5秒内扫描所有幻灯片，把所有用了这个文件名的Image Block全部替换掉。最省心的是，原始尺寸、对齐方式、边框样式这些东西全都会继承下来，不用再调。

用样式刷同步单页图片设置到其他页面

这个方法适合什么场景？你已经在某一页上把图片调得特别精细了——加了阴影、设了圆角、缩放比例调成了85%，还叠了个半透明蒙版。你想把这张图的视觉效果连同图片本身复制到其他页面，用样式刷最方便。

方法一：选中那张已经调好的图片，点顶部工具栏的“Format Painter”图标（是个刷子形状）。鼠标变成刷子光标后，按住Ctrl键，依次点左侧缩略图里目标页面的对应图片块。

方法二：如果目标页还没插入图片，先在那页的对应位置随便放一张图占位，然后再执行样式刷，点一下那个占位图，Gamma就会自动换成源图，并套上所有样式。

通过API脚本触发全项目图片批量切换（进阶）

这个方法适合企业级用户。如果你的PPT有上百页，还要对接CMS系统，手动操作就不现实了。Gamma开放了REST API接口

，支持PATCH请求更新指定Block的image_url字段。

步骤也不复杂：

1、先去Gamma项目设置里把Developer Mode打开（Settings → Advanced → Toggle “Enable API Access”）。

2、拿到当前项目的Project ID和各个Slide ID——从浏览器地址栏或者导出JSON元数据里都能提取。

3、构造curl命令。遍历所有含image_url的Block，把原来的CDN路径批量替换成新图的URL。命令格式大概是这样的：

curl -X PATCH "https://gamma.app/api/v1/slides/abc123/blocks/def456" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"image","data":{"image_url":"https://cdn.newbrand.com/product_v2.jpg"}}'

每条命令执行后，返回HTTP 200就说明替换成功，不用人工去核对结果。

三种方法，覆盖了从个人用户到企业的不同需求。最常用的是第一种，最省心的是第二种，最强大的是第三种。根据你的实际情况选一个就行。