ComfyUI工作流分享API实用指南:4步把你的工作流发到第三方平台 📅 2026/8/19 23:49:16 ComfyUI工作流分享API实用指南4步把你的工作流发到第三方平台【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-ManagerComfyUI-Manager 不仅是插件管理器它自带的工作流分享 API能让你把画布上的节点流程一键发布到 OpenArt、YouML、Copus、eSheep 等多个平台。本文用最少的概念、最直白的代码讲解带你快速上手 ComfyUI工作流分享包括输出节点自动识别、API 密钥配置和常见报错排查。为什么需要工作流分享这件事很多人在 ComfyUI 里搭好了一套不错的生图流程想发到社区分享。传统做法是手动导出 JSON 文件再跑到网页里上传麻烦不说别人拿到文件还不一定跑得起来。ComfyUI-Manager 的思路是在 ComfyUI 界面里直接点一个按钮把当前工作流和产出的图片一起推送给第三方平台。整个流程由js/目录下几个 JavaScript 模块支撑其中js/comfyui-share-common.js是公共入口js/comfyui-share-copus.js、js/comfyui-share-openart.js、js/comfyui-share-youml.js分别是三家平台的对接实现。大白话解释工作流Workflow就是你在画布上摆的那些节点和连线它本质上是一份 JSON 数据记录了输入什么、经过哪些处理、输出什么。3 分钟跑通最小分享流程第 1 步取出画布上的工作流数据分享的第一步是拿到当前工作流的 JSON 表示ComfyUI 已经提供了现成方法// 把画布上的节点流程转成结构化数据 const prompt await app.graphToPrompt(); const workflowJSON prompt[workflow];app.graphToPrompt()是 ComfyUI 暴露的全局能力返回对象里workflow字段就是完整的工作流描述。这段代码做的事情很简单把画面上的流程翻译成电脑能读懂的 JSON后续所有平台都基于这份数据做分享。第 2 步让程序自己找出输出节点不是所有节点都值得分享你真正想发出去的是结果图。ComfyUI-Manager 提供了getPotentialOutputsAndOutputNodes函数自动遍历画布节点挑出带输出内容的那些const nodes app.graph._nodes; const { potential_outputs, potential_output_nodes } getPotentialOutputsAndOutputNodes(nodes);哪些节点会被识别项目里维护了一张白名单也就是SUPPORTED_OUTPUT_NODE_TYPES常量export const SUPPORTED_OUTPUT_NODE_TYPES [ PreviewImage, // 预览图 SaveImage, // 保存图片 VHS_VideoCombine, // 视频合成 ADE_AnimateDiffCombine, SaveAnimatedWEBP, CR Image Output ];potential_outputs收集到的可分享产物图片路径、节点标题、节点 ID 等potential_output_nodes对应的节点对象方便你回查新手提示如果你画布上只有 Checkpoint 加载器、采样器这类中间节点没有上面任何一种输出节点程序会直接提示找不到可分享的输出这是正常行为先加一个 SaveImage 再跑一遍流程即可。第 3 步调用平台专属的分享入口公共模块里封装了三个开箱即用的函数// 打开 Copus 分享对话框 showCopusShareDialog(); // 打开 OpenArt 分享对话框 showOpenArtShareDialog(); // 打开 YouML 分享对话框 showYouMLShareDialog();它们的内部逻辑完全一致先app.graphToPrompt()拿数据再getPotentialOutputsAndOutputNodes筛输出最后弹出自定义分享窗口让你填写标题、描述等信息。如果你想在项目里直接挂一个分享菜单ShareDialogChooser类已经把 OpenArt、YouML、Matrix、ComfyWorkflows、eSheep、Copus 六个入口都排好了相当于一个现成的分享大厅。进阶玩法给分享对话框做定制每个平台的对话框都是基于 ComfyUI 的ComfyDialog基类派生的。以 OpenArt 为例它的结构大致是class OpenArtShareDialog extends ComfyDialog { static instance null; // 单例避免重复弹窗 constructor() { super(); // 初始化对话框 DOM、选中的输出索引、上传图片列表等状态 } createButtons() { // 构建表单输出选择区、API 密钥输入框、标题、描述、分享按钮 } }如果你要自己做一个分享平台照着这个模板写一个子类就行constructor里准备状态createButtons里拼 UI最后在分享按钮的回调里拿potential_outputs调你的后端接口。补充通用分享对话框做了什么除了三家专项平台showShareDialog(share_option)是更通用的入口支持 Matrix 服务器和 ComfyWorkflows。它会做几件关键校验没找到输出节点 → 弹窗提示并列出支持的类型有输出节点但没图 → 提醒你先跑一次流程再分享分享前会检查 Matrix 账号、分享密钥是否已配置OpenArt 的 API 密钥怎么配置OpenArt 分享需要身份验证密钥不是硬编码在代码里的而是通过后端接口存取// 保存密钥 await api.fetchApi(/manager/set_openart_auth, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ openart_key: 你的API密钥 }) }); // 读取已保存的密钥 const key await api.fetchApi(/manager/get_openart_auth) .then(res res.json()) .then(data data.openart_key);YouML 和 Copus 的密钥管理方式不同——YouML 走的是 API TokenCopus 用localStorage存copus_token。无论哪种方式密钥都只存在你本地或本地 Manager 服务里不会发给无关第三方。常见报错与解决办法现象原因处理方式提示没有支持的输出节点画布上缺少白名单里的输出节点补一个 SaveImage 或 PreviewImage 后重跑提示先运行一次流程输出节点存在但还没有产物点一次 Queue Prompt 生成结果再分享弹窗能开但密钥校验失败API 密钥过期或填错重新生成密钥用上面的接口覆盖保存分享按钮点了没反应对话框 CSS 没加载确认引入了 custom-nodes-manager.css、model-manager.css 等样式视频格式分享失败VHS_VideoCombine 只支持 image/gif 和 image/webp换格式或改用图片输出节点分享成功之后会发生什么以 OpenArt 为例分享成功后的回调会改写对话框内的提示信息给你一个可点击的查看链接this.message.innerHTML Workflow has been shared successfully. a href${url} target_blankClick here to view it./a;eSheep 平台比较特殊它走的是shareToEsheep()函数把工作流和图片提交到本地 Manager 的/manager/set_esheep_workflow_and_images接口然后直接新开浏览器标签页跳到 eSheep 的上传页完成发布。写在最后ComfyUI工作流分享 API 的价值在于把导出 → 上传 → 填信息这条繁琐链路压缩成一个按钮而且所有平台共用同一套数据管线接入新平台只需实现一个ComfyDialog子类。如果你是普通用户装好 ComfyUI-Manager在界面里找到分享菜单挑个平台点一下即可完全不用写代码。如果你是开发者推荐直接读js/comfyui-share-common.js里showShareDialog的实现再对照js/comfyui-share-openart.js看一个完整平台的写法你的接入成本会非常低。想深入学习的话可以从这几个文件入手公共分享逻辑js/comfyui-share-common.jsCopus 平台集成js/comfyui-share-copus.jsOpenArt 平台集成js/comfyui-share-openart.jsYouML 平台集成js/comfyui-share-youml.js如果你有 ComfyUI-Manager 的使用问题或改进建议欢迎直接到项目仓库提 Issue 交流。【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考