跳转到主要内容

n8n

PoYo 的 n8n 社区节点让工作流可以提交 PoYo 任务、等待结果,并通过 PoYo 的签名回调恢复执行。它与 REST API 使用相同的 API Key、模型目录、任务状态和结果。 源码和示例工作流:PoyoAPI/poyo-n8n。

前提条件

  • 允许使用 Community Nodes 的 n8n 实例
  • 从 API Key 页面获取的 PoYo API Key

安装

1

安装社区节点

在 n8n 中打开 Settings → Community Nodes → Install,输入 n8n-nodes-poyo。之后在节点面板中搜索 “PoYo”,应能看到 PoYo 节点。
2

创建凭据

打开 Credentials → New credential → PoYo API,粘贴你的 API Key,保留默认的 Base URL https://api.poyo.ai,然后点击 Test。
3

运行示例工作流

下载一个示例工作流,在 n8n 工作流菜单中选择 Import from File,选择你的 PoYo 凭据,然后运行。

示例工作流

Webhook 示例依赖 PoYo 的签名回调。签名请求头见 Webhook 回调。

注意事项

  • API Key 保存在 n8n 凭据中,不会出现在导出的工作流文件里。
  • 请求直接调用 PoYo REST 接口,并附带 X-PoYo-Source 请求头以标识该集成。
  • 任务使用标准状态 not_started、running、finished 和 failed。

故障排查