> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.
[图片叠图插件](https://www.coze.cn/store/plugin/7438921536473612288)用于将一张图片叠加到另一张图片上，实现多层图像的合成效果。通过定义上层图片的位置、边距、缩放比例、透明度等属性，你可以将上层图片（图标、水印、装饰元素等）精准地叠加到底层图片中，满足多样化的设计需求。
## 使用限制 {#488cd54c}
扣子主账号内所有子账号共享**叠图插件**的并发限制 ，其值为 10。
## 计费说明 {#414cfd43}
图片叠图插件根据插件调用次数计费，对应的计费项及单价请参考[插件费用](/coze_pro/plugin_fee)。
## 配置说明 {#b50f6d30}
图片叠图插件包含 add_image_to_image 工具。调用该工具时，你需要上传底层图片和上层图片。如果需要定制化叠加效果，可通过配置缩放、水平边距、位置、垂直边距等参数实现。
### 输入参数 {#7f2008cf}
输入参数说明如下表所示：
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|上层图 |设置上层图片来源，必填参数。 |\
| |支持上传图片或引用上游节点的输出参数。 |\
| |:::tip 说明 |\
| |在调试节点效果时，建议上传一张示例图，用于调整参数配置，并仅测试该节点，快速查看效果。 |\
| |::: |
| | | \
|底图 |设置底层图片来源，必填参数。 |\
| |支持上传图片或引用上游节点的输出参数。 |\
| |:::tip 说明 |\
| |在调试节点效果时，建议上传一张示例图，用于调整参数配置，并仅测试该节点，快速查看效果。 |\
| |::: |
| | | \
|缩放 |设置上层图片缩放的百分比。例如设置为 50，则上层图片将缩小 50%。 |
| | | \
|水平边距 |设置上层图片离底部图片边缘的水平距离。只有当上层图片的初始位置为左上、左中、左下、右上、右中、右下时，该配置才生效。 |\
| | |\
| |* 取值范围：[0,4096]。 |\
| |* 默认值：10。 |\
| |* 单位：px。 |
| | | \
|位置 |设置上层图片叠放的空间位置。 |\
| | |\
| |* se（默认值）：右下。 |\
| |* nw：左上。 |\
| |* north：中上。 |\
| |* ne：右上。 |\
| |* west：左中。 |\
| |* center：中部。 |\
| |* east：右中。 |\
| |* sw：左下。 |\
| |* south：中下。 |
| | | \
|透明度 |设置上层图片的透明度。 |\
| | |\
| |* 取值范围：[0,100] |\
| |* 默认值：100，表示不透明。 |
| | | \
|垂直边距 |设置上层图片离底部图片边缘的垂直距离。只有当上层图片的初始位置为左上、中上、右上、左下、中下、右下时，该配置才生效。 |\
| | |\
| |* 取值范围：[0,4096]。 |\
| |* 默认值：10。 |\
| |* 单位：px。 |
| | | \
|垂直偏移 |设置上层图片的中线垂直偏移量。只有当上层图片的初始位置为左中、中部、右中时，该配置才生效。 |\
| | |\
| |* 取值范围：[-1000,1000]，其中正值表示向上偏移，负值表示向下偏移。 |\
| |* 默认值：0，不偏移。 |\
| |* 单位：px。 |
### 输出参数 {#656a0c5a}
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|data |被添加图片后的图片 URL。URL 有效期为 30 天，请及时转存。 |
| | | \
|msg |执行插件时的状态描述或错误提示信息。 |
## 示例 {#21a21114}
在工作流中调用图片叠图插件，将上层图片叠加到底层图片上。其中，指定上层图片位于底层图片的右上角，同时将上层图片缩小至 20%，透明度调整为 50 %，
叠图效果如下：
::::cols
@col 33
上层图片
@col 33
底层图片
@col 33
叠图效果
::::
> * 叠图插件 ID：7438922391696326696