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