> ## 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.

低代码工作流中的画板节点是一个支持自定义绘制的图形创作节点。画板节点通常用于图文排版和设计场景，例如电商海报、营销 banner、社交媒体博文配图等。
你可以在画板节点中插入各种元素，例如上传指定图片、添加文本、添加矩形等各种线性图形、画笔自由绘制等，还可以添加变量元素，引用上游节点的输出。除此之外，你还可以设置元素图层、画板尺寸、画板颜色、画板透明度等。
在画板编辑区域双击预览图即可编辑画板，你也可以在画板编辑右上角单击图标来进入编辑状态。
:::notice 注意
* 画板节点暂不支持展示 emoji 表情。
* 画板节点输出的图片为链接格式，有效期为 1 年，建议在到期前及时保存。
* 在扣子账号（主账号+子账号）维度下，画板节点的并发限制为 4。
:::
## 变量元素 {#e41fc118}
画板节点中添加的变量可以作为一个画板元素展示在画面中，这种画板元素被称为变量元素。
如果需要引用上游节点的输出参数，作为画板节点的元素之一，可以在画板节点的配置页面元素设置区域单击加号（+）来增加一个元素，元素值引用上游节点的输出参数。
![Image=358x193](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/64f5f6a396e14a7d8dd01b42c871fb8c~tplv-goo7wpa0wc-image.image)
添加变量元素后，此元素不会默认展示在画布中，你需要在画布手动添加这个元素。目前支持通过以下方式在画布中添加变量元素：
<!-- @cols-width: 152,414,274 -->
| | | | \
|**添加方式** |**操作说明** |**示例** |
|---|---|---|
| | | | \
|直接插入变量元素 |在画布中单击引用变量图标，添加一个变量元素。默认插入与变量类型相同的元素对象，即 String 类型对应文本对象，image类型对应图片对象。 |\
| | |\
| | |例如根据指定输入文案生成小红书笔记配图。我们可以在开始节点中添加输出参数 title，并在画板节点中引用这个参数 title，title 参数的值会自动添加到画板节点中。 |\
| | |![Image=1159x461](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1f8bd2ae482846839a1cf05cd04c99fe~tplv-goo7wpa0wc-image.image) |\
| | | |
| | | | \
|在固定元素中设置引用变量 |如需为固定元素设置引用，选中文本对象或图片对象，并在配置框中选择要引用的变量即可。 |\
| |固定元素中，仅文本对象和图片对象可以引用变量，且均可引用 image 和 String 类型的变量。 |\
| | |\
| |* 如果文本对象引用了 image 变量，最终生成的图片中，本文框内会展示变量对应图片的 URL。 |\
| |* 如果 String 变量的值是一个公开可访问的图片 URL，那么图片对象可以引用这个 String 变量，最终生成的图片中，自动将 URL 渲染为图片。 |![Image=1198x666](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b5f21f1bb73c4d8d9eac8e67981e2c66~tplv-goo7wpa0wc-image.image) |

## 固定元素 {#8e00ee39}
固定元素指添加到画板中的非变量元素，包括本地上传的图片、固定文本、画板中绘制的线性图形、画笔自由绘制等。对于固定元素的常见操作如下：
<!-- @cols-width: 152,414,274 -->
| | | | \
|**操作** |**说明** |**示例** |
|---|---|---|
| | | | \
|添加图片 |在画板中单击对应图标，上传一张本地图片到画板节点中。 |\
| |添加图片后，可以设置**填充样式**和**描边样式**。 |![Image=1896x732](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/090b1ba137ff42b4aa5f958c23f968e4~tplv-goo7wpa0wc-image.image) |
| | | | \
|添加文字 |在画板中单击对应图标，添加一段文本内容到画板节点中。支持添加单行文本或区块文本，其中区块文本指固定大小的文本框。 |\
| |添加文本框后，双击文本框可以设置文字内容，单击文本框可以调整文字的大小、位置等展示效果。 |![Image=1202x440](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/40a7b15a2b3a4d98a423200652e8db43~tplv-goo7wpa0wc-image.image) |
| | | | \
|添加图形 |在画板中单击对应图标，添加一个线性图形到画板节点中。 |\
| |添加图形后，可以设置**填充样式**和**描边样式**。 |![Image=1011x628](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e6f10d16710d4b64b48b73e61ae92050~tplv-goo7wpa0wc-image.image) |
| | | | \
|画笔模式 |在画板中单击对应图标，进入画笔模式。 |\
| |在画笔模式下，你可以自由操控鼠标或触控板，在画板中自由绘制。 |\
| |如需删除画笔轨迹，可以单击画笔图标退出画笔模式，再按下键盘上的 **Delete** 键。 |![Image=1012x665](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/57fa2dc82d7c451c97f5196347822275~tplv-goo7wpa0wc-image.image) |

## 元素样式 {#e806fde5}
添加变量元素和固定元素之后，可以随时调整元素的样式、展示效果、通过快捷键复制或删除元素。
<!-- @cols-width: 152,414,274 -->
| | | | \
|**操作** |**说明** |**示例** |
|---|---|---|
| | | | \
|调整元素样式 |选中变量元素，可以快速调整变量元素的位置、元素大小等。选中变量元素后，界面会浮现出用于编辑图形的工具栏，你还可以在浮现的工具栏中点击相应图标，调整变量元素的外观样式，例如调整字体大小、颜色、字体类型等。 |\
| |此外，你还可以在画板中修改变量元素，直接预览显示效果，例如编辑文字预览效果、更换图片预览效果。 |![Image=868x560](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3f2d0ab0f9aa4fbaac7e2442a59125b3~tplv-goo7wpa0wc-image.image) |
| | | | \
|调整元素位置 |在画布中直接鼠标拖拽元素即可移动元素位置。移动时页面会显示坐标辅助线，帮助你判断元素之间的相对位置。 |\
| |选中多个元素之后，还可以批量设置对齐方式。 |* 移动： |\
| | | |\
| | |![Image=1194x666](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/35fad9da8990416690931031df339df2~tplv-goo7wpa0wc-image.image) |\
| | | |\
| | |* 对齐： |\
| | | |\
| | |![Image=773x631](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/14efb504adf94c049b9b3f9b9af339ef~tplv-goo7wpa0wc-image.image) |
| | | | \
|快捷键操作 |画布中支持通过以下快捷键复制操作： |\
| | |\
| |* Command/Ctrl+C：拷贝 |\
| |* Command/Ctrl+V：粘贴 |\
| |* Command/Ctrl+D：拷贝并粘贴 |\
| |* Alt+鼠标拖拽：自定义坐标快速复制 |\
| |* Backspace/Delete：删除 |![Image=1198x666](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9be2d926113f43e7baaab52f65f6c0b2~tplv-goo7wpa0wc-image.image) |
| | | | \
|删除元素 |支持快捷键（Backspace/Delete）删除变量元素在内的所有元素。 |![Image=1194x666](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6b8d5e9315a947e2ad9589fed652ab6c~tplv-goo7wpa0wc-image.image) |

## 画板设置 {#f1d47b10}
画板节点的基础设置包括尺寸、颜色、透明度等画板设置、元素图层、预览比例等。
<!-- @cols-width: 152,414,274 -->
| | | | \
|**操作** |**说明** |**示例** |
|---|---|---|
| | | | \
|调整画板设置 |在画板中单击对应图标，调整画板设置。支持调整画板尺寸、颜色和透明度。 |![Image=1116x626](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2145652603fa439f89c704bc9b575910~tplv-goo7wpa0wc-image.image) |
| | | | \
|重置视图 |调整预览比例后，单击重置视图图标，恢复到 100% 预览比例。 |![Image=1094x732](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8a9a5112636544af85934a2a84307d7c~tplv-goo7wpa0wc-image.image) |\
| | |![Image=922x782](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3bea0dcdb72949e19118f70bb4521447~tplv-goo7wpa0wc-image.image) |
| | | | \
|调整预览比例 |在画板中单击加号或减号，调整预览比例。预览的最小比例为 100%。 |![Image=760x399](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b44e76085e9b49e8a8316a24db71a430~tplv-goo7wpa0wc-image.image) |
| | | | \
|调整元素图层 |选中元素后，在画板中单击对应图标，将指定元素置底或置顶。适用于元素重叠展示的场景下调整元素所在图层，例如在某个图形上叠加文字。 |![Image=816x390](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6d1c93732b7844fe97116f4ce44a2db5~tplv-goo7wpa0wc-image.image) |

## 输出 {#d55cc61f}
画板节点的输出参数固定为：

* data：Image 格式的图像，即排版后的最终图像。通常是一个公开可访问的 URL 链接。
* msg：节点执行状态，success 表示处理成功。
* errorBody：节点执行失败时的详细信息，包括 errorMessage 和 errorCode。
* isSuccess：节点执行状态，true 表示执行成功，false 表示执行失败。

其中`isSuccess`、`errorBody` 仅在节点的异常处理方式设置为**返回设定内容**或**执行异常流程**时返回，用于节点执行异常时传递详细信息。
### 异常设置 {#a078ec1f}
默认情况下，节点运行超时、运行异常时，工作流会中断，工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式，例如超时时间、是否重试、是否跳转异常分支等。
<!-- @cols-width: 188,664 -->
| | | \
|**异常处理设置** |**说明** |
|---|---|
| | | \
|超时时间 |超时时间指节点运行的最大耗时，如果超过此时长，则判断为节点运行超时。 |\
| |默认情况下，节点的超时时间默认为 60s，即 1 分钟。你也可以将其改为 0.1s~60s，灵活控制超时时间。 |
| | | \
|重试次数 |节点运行超时或异常时，默认不重试，你也可以设置为重试 1 次。 |
| | | \
|异常处理方式 |节点运行超时或异常时，默认中断工作流。你也可以手动修改此节点的异常处理方式： |\
| | |\
| |* **中断流程**：工作流执行中断，不再运行后续节点。 |\
| |* **返回设定内容**：发生异常后，工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容，必须是输出中已定义的字段，且格式为合法的 JSON 格式。另外，节点还会返回输出参数 `isSuccess`、`errorBody`，传递节点异常的详细信息。 |\
| |* **执行异常流程**：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 `isSuccess`、`errorBody` 返回。 |

![Image=307x280](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/29a3611502344180aed9eaf50fe9e2a7~tplv-goo7wpa0wc-image.image)


## 示例 {#fee14b04}
例如通过画板节点搭建一个生成小红书配图的图像流。其中：

* 添加变量元素 mbti 和 title，引用开始节点的输入参数，作为画板中动态调整的 MBTI 部分、主题部分。
* 添加变量元素 image，引用开始节点的图片输入，作为画板中的配图。
* 最后为图片设置一个底色、调整尺寸即可。


::::cols
@col 50
画板节点配置：
![Image=1877x840](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/684b62938c9345fea078858d3f23ed77~tplv-goo7wpa0wc-image.image)



@col 50
生成效果：
![Image=250x269](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/693b8b082dee4b69a3e506db04c25a0a~tplv-goo7wpa0wc-image.image)

::::