邀请好友，获取免费 Tokens！了解更多

🚀 n8n 接入CodingPlanx自定义大模型教程

在 n8n 中，我们可以通过配置自定义 API 域名和密钥 (API Key)，轻松接入第三方大语言模型（LLM）。

本教程将详细演示如何以 https://api.codingplanx.ai 为例，在 n8n 中配置并使用自定义 AI 模型。

📋 准备工作

在开始之前，请确保您已经具备以下条件：

  1. 已安装并运行的 n8n（本地化部署或 Cloud 版本均可）。
  2. CodingPlanX 的 API Key（通常以 sk- 开头）。
  3. 了解您想要调用的具体模型名称（例如：gpt-4o, claude-3-5-sonnet 等）。

🛠️ 第一步：在 n8n 中创建 API 凭证 (Credentials)

由于绝大多数自定义 API 都兼容 OpenAI 格式，我们将使用 n8n 内置的 OpenAI 凭证进行配置。

  1. 打开 n8n 面板，点击左侧菜单栏的 Credentials（凭证）。
  2. 点击右上角的 + Add Credential（添加凭证）按钮。
  3. 在搜索框中输入 OpenAI，然后选择 OpenAI API。

⚙️ 第二步：配置自定义 API 地址与密钥

在打开的凭证配置页面中，按以下步骤填写参数：

  1. Name（凭证名称）：为这个凭证起一个好记的名字，例如：CodingPlanX API。

  2. API Key（密钥）：填入您获取到的 API Key（sk-xxxxxx...）。

  3. Base URL（核心步骤）：

    • 默认情况下，n8n 使用官方的 OpenAI 地址。我们需要覆盖它。
    • 找到 Base URL 设置项（如果没看到，请点击底部的 Make a custom API call 或确保你的 n8n 版本支持直接修改 Base URL）。
    • 将地址修改为： 
      https://api.codingplanx.ai/v1

    > 💡 注意：绝大多数兼容 OpenAI 格式的 API 都需要在域名后加上 /v1 后缀，请务必不要漏掉。

  4. 点击右上角的 Save（保存）按钮。如果配置正确，系统会提示 Connection tested successfully（连接测试成功）。

🧩 第三步：在工作流中添加并配置 AI 模型节点

凭证配置好后，我们就可以在工作流中使用它了。

  1. 进入 Workflows（工作流），点击 + Add workflow 创建新工作流。
  2. 在画布上点击 + 号，搜索并添加一个 OpenAI 节点（通常选择 Chat Model 聊天模型）。
  3. 单击打开该节点进行设置：
    • Credential to connect with：在下拉菜单中选择您刚刚创建的 CodingPlanX API。
    • Model（模型选择）：
      • 由于使用的是自定义 API，下拉列表中可能无法直接拉取到您的模型。
      • 点击 Model 字段旁边的 ⚙️（齿轮图标）或选择 Expression（表达式）/ Custom（自定义）模式。
      • 手动输入您要使用的模型名称，例如：gpt-3.5-turbo

✅ 第四步：测试运行

  1. 在 AI 节点前方连接一个 Manual Trigger（手动触发）节点，或者连接到您的基础 Agent 流程中。
  2. 在 AI 节点中输入一条测试 Prompt（提示词），例如："你好，请介绍一下你自己。"。
  3. 点击 Execute Node（执行节点）或 Test step。
  4. 在右侧的 Output（输出）面板中，如果您看到了 AI 的回复，恭喜您！自定义模型已成功接入！🎉

❓ 常见问题排查 (FAQ)

Q1: 报错 Invalid API Key 或 AuthenticationError 怎么办？

  • 检查您的 API Key 是否复制完整，确保前后没有多余的空格。
  • 确认您的账号内是否有足够的余额。

Q2: 报错 Resource not found 或 404？

  • 请检查您在第二步填写的 Base URL。确保正确填写了 https://api.codingplanx.ai/v1（检查是否漏掉了 /v1 或者多加了斜杠）。

Q3: 报错 Model not found？

  • 请核对您在节点中手动填写的模型名称是否正确。第三方平台支持的模型名称可能与官方略有不同，请参考 CodingPlanX 的官方模型列表。