生成图像
运行易用的 PoYo 图像生成节点，并保存返回的图像。
全部集成
集成指南
安装 PoYo for ComfyUI
本地可视化 AI 工作流
把 PoYo 图像、视频和音频模型放到本地 ComfyUI 节点旁，通过可视化连接处理输入和结果文件。
开始之前
- ComfyUI 0.32.0 或更高版本
- Git 和 PoYo API Key
三步完成并验证安装
按顺序完成每一步。每一步都写明去哪里操作，以及看到什么结果后才能继续。
- 1
检查 ComfyUI 版本
如果当前版本低于 0.32.0，请先更新 ComfyUI，再安装 PoYo 节点包。
看到这个结果后继续: ComfyUI 显示的版本为 0.32.0 或更高。 - 2
安装节点并重启 ComfyUI
把官方仓库克隆到 custom_nodes，然后完整重启 ComfyUI，让它加载新节点包。
终端cd ComfyUI/custom_nodes git clone https://github.com/PoyoAPI/poyo-comfyui.git看到这个结果后继续: 在节点菜单搜索 PoYo，可以看到已经安装的 PoYo 节点。 - 3
配置 API Key
启动 ComfyUI 前设置 Key，或者使用本地配置命令。不要把 Key 填进工作流节点字段。
Windowsset POYO_API_KEY=your_poyo_api_key set POYO_BASE_URL=https://api.poyo.aimacOS / Linuxexport POYO_API_KEY=your_poyo_api_key export POYO_BASE_URL=https://api.poyo.ai本地配置替代方式python -m poyo_nodes.configure看到这个结果后继续: PoYo 节点可以加载实时模型目录，并且没有鉴权错误。
运行第一个 PoYo 工作流
先使用官方示例验证安装和凭据，再开始搭建更复杂的工作流。
选择一个示例工作流
先用一个与目标场景相符的最小示例，验证安装、凭据和结果链路。
提交并等待结果
提交通用目录模型，等待任务完成，然后保存结果文件。
如何导入
- 1下载 JSON 文件。
- 2把文件拖到 ComfyUI 画布，或者选择 Workflow → Open。
- 3选择模型并确认输入，然后点击 Queue Prompt。
- 1从官方仓库下载一个示例工作流。
- 2在 ComfyUI 中打开示例，并从实时目录选择模型。
- 3点击 Queue Prompt，等待 PoYo 任务完成。
- 4在 ComfyUI/output/poyo 中找到保存的结果。
第一次成功: 队列执行完成，并且 ComfyUI/output/poyo 中出现生成结果。
如果没有成功
- 没有出现 PoYo 节点
- 完整重启 ComfyUI，并检查启动控制台是否出现 poyo_nodes 导入错误。
- 模型目录无法加载
- 检查 API Key 与网络连接；修改环境变量后需要重新启动 ComfyUI。
- 工作流找不到输出
- 等待任务进入 finished，再检查 Save Result File 节点和 ComfyUI/output/poyo。
技术细节
这些信息对生产集成很重要，但不是完成第一次运行的前提。
- 凭据不会写入导出的工作流文件。
- 任务沿用 not_started、running、finished、failed 四种公开状态。
- 插件直接调用现有 PoYo REST 接口，并通过 X-PoYo-Source 标识来源。