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 · 核驗日期