API 集成指南
n8n 接入 EasyAPI
通过 n8n HTTP Request 节点调用 EasyAPI。可下载的工作流使用手动触发与最小对话请求,便于直接核对端点和 JSON。
准备条件
API Key 只保存在服务端环境变量或 n8n 凭证中。分享代码和导出工作流时,不应包含生产密钥。
配置步骤
- 导入工作流,创建 HTTP Header Auth 凭证,名称为 Authorization,值为 Bearer 加空格和 API Key;在 HTTP Request 节点选择该凭证。
- 将 REPLACE_WITH_CATALOG_MODEL 换成目录中的对话模型。请求采用 POST、JSON 和 /v1/chat/completions 端点。
- 执行手动触发,检查 choices[0].message.content。第一次保持非流式;确认 JSON 后再连接后续节点。
可运行请求
示例使用当前选择的公开模型;实际访问权限和限额仍取决于 API Key 与账户分组。 deepseek-v4-pro-0813
curl https://token.easyapi.com/v1/chat/completions \
-H "Authorization: Bearer $EASYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-pro-0813","messages":[{"role":"user","content":"Reply with one short greeting."}],"stream":false}'下载 n8n 工作流成功判据
成功请求应返回非空的助手消息。扩大流量前,核对调用记录与实际费用。
兼容范围与限制
本指南只覆盖文本 Chat Completions。图片、视频、向量、工具调用和结构化输出,均需分别核对模型和端点;兼容 OpenAI 客户端不代表支持每个厂商的全部功能。
阅读 API 文档常见问题与排错
- 导出的工作流可以分享吗?
- 下载文件既没有密钥,也没有凭证 ID。所选 Header Auth 凭证由 n8n 单独保存;后续导出分享前仍需检查文件。
- 为什么不用 AI Agent 节点?
- HTTP Request 让端点、请求体和返回结果清晰可见,也不预设模型支持工具。AI Agent 或 OpenAI Chat Model 节点需另行配置模型与凭证。
- 遇到 401、404、429 怎么排查?
- 401 检查凭证和 Bearer 前缀;404 检查基础地址、端点与模型 ID;429 检查账户限额并使用有上限的重试,避免无限循环。
官方资料
n8n · 核验日期