API 集成指南

n8n 接入 EasyAPI

通过 n8n HTTP Request 节点调用 EasyAPI。可下载的工作流使用手动触发与最小对话请求,便于直接核对端点和 JSON。

准备条件

API Key 只保存在服务端环境变量或 n8n 凭证中。分享代码和导出工作流时,不应包含生产密钥。

配置步骤

  1. 导入工作流,创建 HTTP Header Auth 凭证,名称为 Authorization,值为 Bearer 加空格和 API Key;在 HTTP Request 节点选择该凭证。
  2. 将 REPLACE_WITH_CATALOG_MODEL 换成目录中的对话模型。请求采用 POST、JSON 和 /v1/chat/completions 端点。
  3. 执行手动触发,检查 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 · 核验日期