> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> 如何在 n8n 接入大模型:通过 OpenAI 节点和自定义 Base URL 在工作流里使用 RuAPI 的模型

[n8n](https://n8n.io) 是带可视化编辑器的自动化平台,有 AI 模块(AI Agent、OpenAI、链)。RuAPI 通过**改了 Base URL 的 OpenAI 凭据**接入 —— 配好之后,所有 AI 节点都走我们。

## 前置

<Steps>
  <Step title="RuAPI 账号和密钥">
    控制台 →\*\*「令牌」\*\*→ 创建 `sk-...` 密钥。余额用 USDT 充 —— 见[充值](/zh/topup)。
  </Step>
</Steps>

## 创建凭据

<Steps>
  <Step title="新建 OpenAI 凭据">
    在 n8n:**Credentials → New → OpenAI**。
  </Step>

  <Step title="填字段">
    | 字段           | 值                                         |
    | ------------ | ----------------------------------------- |
    | **API Key**  | `sk-你的密钥`                                 |
    | **Base URL** | `https://www.ruapi.ai/v1`  —— **带** `/v1` |

    <Note>
      **Base URL** 字段可能藏在 OpenAI 凭据表单的「可选字段」(齿轮)里。填好保存凭据。
    </Note>
  </Step>
</Steps>

## 在节点里用

<Steps>
  <Step title="加一个 AI 节点">
    把 **OpenAI** 节点或 **AI Agent**(带 OpenAI Chat Model)拖到画布上。
  </Step>

  <Step title="选 RuAPI 凭据">
    在节点的 Credentials 字段里选你刚建的凭据。
  </Step>

  <Step title="指定模型">
    填[价格页](https://www.ruapi.ai/pricing)上的精确模型 ID。下拉里没有就手动填 ID(「By ID」模式或表达式)。
  </Step>
</Steps>

## 验证

用一句简单提示跑这个节点(「你好,用一个词回答」)。有回复 + RuAPI 控制台 →\*\*「日志」\*\*有记录,就是通了。

## 出问题时

<AccordionGroup>
  <Accordion title="401 / Unauthorized">
    * API Key 得是 RuAPI 令牌(`sk-...`)。
    * 确认凭据里的 Base URL 是带 `/v1` 的 `https://www.ruapi.ai/v1`。
  </Accordion>

  <Accordion title="看不到 Base URL 字段">
    在 OpenAI 凭据表单里展开可选/附加字段。当前的 self-hosted 和云端 n8n 都有这个字段。
  </Accordion>

  <Accordion title="下拉里没有我的模型">
    列表显示的是 OpenAI 模型。手动填模型 ID —— 要和 RuAPI 一字不差。
  </Accordion>
</AccordionGroup>