Source: https://wiki.niceai.dev/guide/clients/n8n

# n8n 接入自定义 API

在 n8n 新建一个 **OpenAI** 类型的凭据，API Key 填 NiceAI 密钥，**Base URL** 填 `https://api.niceai.dev/v1`。使用该凭据的 OpenAI、OpenAI Chat Model 等节点都会走这个地址。

## 准备工作

在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按所用模型选择。

## 配置凭据

1. 打开 **Credentials**，新建一个 **OpenAI** 凭据。
2. 填写：

| 字段 | 填写内容 |
| --- | --- |
| API Key | 你的 NiceAI 密钥 |
| Organization ID | 留空 |
| Base URL | `https://api.niceai.dev/v1` |

3. 保存。n8n 会请求 `Base URL/models` 测试凭据，通过即表示密钥和地址正确。


n8n 官方文档的凭据页没有单独介绍 Base URL 字段，但 n8n 的 OpenAI 凭据源码中有该字段（默认值为 `https://api.openai.com/v1`）。如果你的版本没有这个字段，请先升级 n8n。


## 在工作流中使用

1. 添加 **AI Agent** 或 **Basic LLM Chain** 节点，挂上 **OpenAI Chat Model** 子节点，凭据选择刚才创建的那个。
2. 模型可以从列表中选，也可以切换到按 ID 输入，填 [模型广场](https://niceai.dev/model-plaza) 中的模型名。
3. 执行一次测试。

### Use Responses API 开关

较新版本的 OpenAI Chat Model 节点有 **Use Responses API** 开关，打开时请求 `/v1/responses`，关闭时请求 `/v1/chat/completions`。如果所选模型或分组不支持 Responses 接口，关闭此开关即可。

## 常见问题

### 凭据测试 404？

Base URL 缺了 `/v1`，或后面多了路径。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 报错提示模型不存在，但模型名没写错？

先检查 Use Responses API 开关，把它关掉再试。

## 下一步

- [Dify 接入](https://wiki.niceai.dev/guide/clients/dify)
- [OpenAI SDK 接入](https://wiki.niceai.dev/guide/clients/openai-sdk)
