提交并等待结果
提交 PoYo 任务，等待任务完成，并把结果交给下一个 n8n 节点。
全部集成
集成指南
安装 PoYo for n8n
无代码与低代码自动化
把 PoYo 生成能力连接到表单、定时任务、Webhook、数据库和你已经在使用的业务应用。
开始之前
- 允许安装 Community Nodes 的 n8n 实例
- PoYo API Key
三步完成并验证安装
按顺序完成每一步。每一步都写明去哪里操作，以及看到什么结果后才能继续。
- 1
创建 PoYo API Key
在 PoYo 控制台创建一个供 n8n Credential 使用的 Key，并保留页面，第三步需要复制它。
创建 API Key看到这个结果后继续: 新 Key 已创建，并且当前可以复制。 - 2
在 n8n 中安装社区节点
使用 n8n 界面完成标准安装。npm 方式只适合高级自托管部署，不作为普通用户主路径。
Settings → Community Nodes → Install → n8n-nodes-poyo看到这个结果后继续: 添加节点时搜索 PoYo，可以看到已经安装的 PoYo 节点。 - 3
创建并测试 Credential
创建 PoYo API Credential。除非使用自托管网关，否则保留默认 Base URL；粘贴 API Key 后运行测试。
Credentials → New credential → PoYo API → Test看到这个结果后继续: n8n 提示连接成功，并能读取当前 PoYo 账户。
运行第一个 PoYo 工作流
先使用官方示例验证安装和凭据，再开始搭建更复杂的工作流。
选择一个示例工作流
先用一个与目标场景相符的最小示例，验证安装、凭据和结果链路。
Webhook 返回结果
通过已签名的 PoYo 回调恢复 n8n 工作流，并读取最终结果。
如何导入
- 1下载 JSON 文件。
- 2在 n8n 工作流菜单中选择 Import from File。
- 3选择 PoYo Credential，检查示例输入，然后运行工作流。
- 1从官方仓库导入一个示例工作流。
- 2从实时目录选择模型，并填写示例输入。
- 3运行工作流，等待 PoYo 任务完成。
- 4确认最后一个节点拿到结果 URL 或下载文件。
第一次成功: 本次执行成功结束，最后一个节点包含 PoYo 结果 URL 或文件。
如果没有成功
- 搜索不到 PoYo 节点
- 确认当前 n8n 实例允许 Community Nodes，并且安装列表中已经显示 n8n-nodes-poyo。
- Credential 测试返回 401
- 重新创建 PoYo Key，粘贴时不要带首尾空格，并保留默认 API URL https://api.poyo.ai。
- 任务等待时间过长
- 再次提交前先查询原任务状态。重复提交可能产生另一笔付费生成。
技术细节
这些信息对生产集成很重要，但不是完成第一次运行的前提。
- 凭据不会写入导出的工作流文件。
- 任务沿用 not_started、running、finished、failed 四种公开状态。
- 插件直接调用现有 PoYo REST 接口，并通过 X-PoYo-Source 标识来源。