助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈

图片裁剪插件

更新于: 2026-06-24 15:44:40

图片裁剪插件用于对图片进行自定义裁剪。当你需要从原始图片中裁剪出特定区域(例如风景照中的特定风景、人物照中的脸部特写等)时,可以调用该插件,定义裁剪的起始位置、宽度、高度等属性来指定裁剪的区域。

使用限制

扣子主账号内所有子账号共享图片裁剪插件的并发限制 ,其值为 4。

计费说明

图片裁剪插件根据插件调用次数计费,对应的计费项及单价请参考插件费用

配置说明

图片裁剪插件绑定了 cut_image 工具进行图片裁剪。裁剪前,你需要选择裁剪点的初始位置,还可以设置坐标轴偏移量 xy 调整裁剪起始点的位置,然后指定高度宽度来确认图片的裁剪区域,最终完成图片的裁剪。

裁剪起始点
Image

裁剪方式
Image

输入参数

输入参数说明如下表所示:

参数

说明

原图

设置原始图片来源,必填参数。
支持上传图片或引用上游节点的输出参数。

说明

在调试节点效果时,建议上传一张示例图,用于调整参数配置,并仅测试该节点,快速查看效果。

高度

设置裁剪后的图片高度。

  • 取值范围:[0,图片原始高度]。
  • 单位:px。
  • 默认值:图片原始高度。

位置

设置裁剪点的起始位置。

  • nw(默认值):左上。
  • north:中上。
  • ne:右上。
  • west:左中。
  • center:中部。
  • east:右中。
  • sw:左下。
  • south:中下。
  • se:右下。

宽度

设置裁剪后的图片宽度。

  • 取值范围:[0,图片原始宽度]。
  • 单位:px。
  • 默认值:图片原始宽度。

x

设置裁剪起始点的横坐标偏移量。

  • 设置为正值,表示横坐标向右偏移。
  • 设置为负值,表示横坐标向左偏移。
  • 单位:px。

y

设置裁剪起始点的纵坐标偏移量。

  • 设置为正值,表示纵坐标向下偏移。
  • 设置为负值,表示纵坐标向上偏移。
  • 单位:px。

输出参数

说明

关闭指定输出参数的开启功能后,该输出参数将不会被返回给大模型。

参数

说明

data

被裁剪后的图片 URL。URL 有效期为 30 天,请及时转存。

msg

执行插件时的状态描述或错误提示信息。

示例

在工作流中调用图片裁剪插件,裁剪图片。其中,指定左上角(nw)为初始位起始点,x 轴偏移量为 100 像素,y 轴偏移量为 100 像素,裁剪后图片的宽度和高度均为 200 像素。
Image
裁剪后效果

原始图片
Image

确认裁剪位置和尺寸
Image

裁剪后的图片
Image

  • 裁剪插件 ID:7438919975403880460