画布节点操作手册

本文档记录画布节点的主要用途和操作流程，方便使用和后续开发维护。当前先介绍文本节点。

文本节点

文本节点用于保存提示词、草稿、说明文案和 AI 生成的文字结果。它既可以作为独立文本内容，也可以作为下游生成配置节点的输入。

编辑文本内容

• 双击文本节点内容区域，直接编辑节点里的文字。
• 选中文本节点后，点击顶部工具栏的“编辑文字”，进入文字编辑状态。
• 顶部工具栏的“缩小”和“放大”用于调整文本节点字号。

用下方对话框生成或修改文本

• 选中文本节点后，点击顶部工具栏的“编辑”，打开节点下方对话框。
• 文本节点下方对话框只用于生成或改写文本，不承担生图功能。
• 当文本节点为空时，输入框用于填写想生成的文本内容；点击发送后，结果会回填到当前文本节点。
• 当文本节点已有内容时，输入框用于填写想把本段文本修改成什么；点击发送后，会在右侧生成新的文本节点，并自动连接原节点和新节点。
• 输入内容可以手写，也可以从提示词库选择。
• 对话框里的模型下拉来自全局配置里已拉取的模型列表；选择结果只作用于当前节点，不会修改其它节点或全局默认模型。
• 如果下拉中没有模型，需要先打开配置弹窗拉取模型列表，并设置默认生图模型和默认文本模型。火山方舟 Agent Plan 若提示不支持 /models，请手动填写模型名。

用文本节点生成图片

• 先在文本节点中准备好要用于生图的文本内容。
• 点击文本节点顶部工具栏的“生图”按钮。
• 系统会在文本节点右侧自动创建一个生成配置节点，并连接文本节点到生成配置节点。
• 生成配置节点会读取上游文本内容作为生图提示词，并立即开始生成图片。
• 后续需要调整模型、比例、数量时，可以在生成配置节点里修改后再次生成。

用图片节点继续生成图片

• 选中空图片节点后点击“生成”，会直接在当前节点里生成结果，不再额外保留一个空框。
• 当数量为 1 时，生成结果会直接回填到当前图片节点。
• 当数量大于 1 时，当前图片节点会作为主图节点，右侧继续生成对应数量的子图节点。
• 如果图片节点本身已经有内容，则会沿用已有图片作为参考图，再生成新的图片批次。
• 每个生成出来的图片节点都会在自身 metadata 下记录提示词、生成类型、模型、尺寸、质量、数量和参考图引用，方便后续重试。
• 如果重试时参考图已经丢失或无法恢复，系统会直接提示，避免误发空的图生图请求。

视频节点

• 工具栏可以新建视频节点，也可以拖入或上传本地视频文件。
• 视频节点使用原生播放器展示内容，可在节点内直接播放、暂停和拖动进度。
• 空视频节点下方对话框可输入提示词生成视频，结果会回填到当前节点。
• 从文本、图片或配置节点创建视频生成时，会在右侧生成新的视频节点并自动连接。
• 生成配置节点的视频模式会读取上游文本作为 prompt，读取上游图片作为参考图，读取上游视频作为参考视频，并在输入预览里显示参考视频。
• 视频生成接口支持 OpenAI 风格的 POST /v1/videos、GET /v1/videos/{id} 和 GET /v1/videos/{id}/content。
• 使用火山方舟 Agent Plan / Seedance 2.0 时，Base URL 配置为 https://ark.cn-beijing.volces.com/api/plan/v3，模型名使用 Seedance 2.0 对应模型；系统会改用 POST /contents/generations/tasks 创建异步任务，并轮询 GET /contents/generations/tasks/{id}。
• Agent Plan 专属 /api/plan/v3 当前未提供 OpenAI /models 模型列表接口，后台不会伪造模型列表；请手动填写 doubao-seedance-2.0 或文档列出的其他可用模型。
• Seedance 参考视频必须是公网可访问 URL，或由本项目后端在配置 PUBLIC_BASE_URL 后上传并暴露的参考素材 URL。本地/内网地址无法被火山服务器拉取。

推荐流程

1. 新建文本节点，写入图片创作想法。
2. 打开文本节点下方对话框，让 AI 优化或扩写这段提示词。
3. 改写结果会生成到新的文本节点，保留原始文本方便对比。
4. 确认文本节点内容后，点击顶部工具栏“生图”。
5. 在自动创建的生成配置节点中继续调整图片参数或重新生成。