n8n 免费 LLM API
n8n 是一款带有 AI 节点的工作流自动化工具。其 OpenAI 凭据包含 Base URL 字段,因此您可以将请求发送到任何兼容 OpenAI 的 API。本指南将该字段指向 FreeLLMAPI。FreeLLMAPI 通过一个密钥汇集 45 个免费提供商套餐。当某个限制导致请求失败时,它会切换到下一个提供商。
代码、模型名称和目录中的实时标签以英文显示。
所需条件
- n8n,自托管或使用 n8n Cloud。云端实例无法访问您计算机上的
localhost。对于 n8n Cloud,FreeLLMAPI 必须具有公共 HTTPS 地址。 - FreeLLMAPI,通过 Docker 或桌面应用安装。请在密钥页面至少添加两个免费提供商密钥。
- 统一密钥,来自 FreeLLMAPI 的密钥页面。n8n 只使用这个密钥。
安装 FreeLLMAPI(macOS 或 Linux)
curl -fsSL https://freellmapi.co/install.sh | bashBase URL 取决于 n8n 的运行位置。在 Docker 容器内,localhost 指的是容器,而不是您的计算机。
| n8n 运行于 | Base URL |
|---|---|
| 主机上(npm 或 npx) | http://localhost:3001/v1 |
| Docker Desktop 中(macOS、Windows) | http://host.docker.internal:3001/v1 |
| Linux 上的 Docker,与 FreeLLMAPI 位于同一主机 | http://freellmapi:3001/v1,需先将 n8n 容器连接到 FreeLLMAPI 的 Docker 网络 |
| n8n Cloud | FreeLLMAPI 服务器的公共 HTTPS 地址,末尾加上 /v1 |
第 1 步:创建 OpenAI 凭据
- 在 n8n 中,打开 Credentials,创建一个类型为 OpenAI 的新凭据。
- 在 API Key 中,粘贴您的 FreeLLMAPI 统一密钥。
- 将 Organization ID (optional) 留空。
- 在 Base URL 中,将
https://api.openai.com/v1替换为您的 FreeLLMAPI 地址,例如http://host.docker.internal:3001/v1。 - 保存凭据。
所有使用此凭据的 OpenAI 节点现在都会将请求发送到 FreeLLMAPI。您的真实提供商密钥保存在 FreeLLMAPI 中,不会放入 n8n。
从 n8n 容器测试 URL
docker exec n8n wget -qO- \
--header="Authorization: Bearer <unified-key>" \
http://host.docker.internal:3001/v1/models | head -c 300第 2 步:构建 AI Agent 工作流
AI Agent 节点需要一个聊天模型子节点和至少一个工具子节点。从 n8n 1.82.0 起,每个 AI Agent 节点都以 Tools Agent 方式运行。智能体会将工具定义发送给模型,因此模型必须支持工具调用。
- 添加一个 Chat Trigger 节点。它会提供一个聊天窗口,用于测试工作流。
- 在触发器之后添加一个 AI Agent 节点。
- 将一个 OpenAI Chat Model 子节点连接到智能体的 Chat Model 输入。选择您的 FreeLLMAPI 凭据。
- 在 Model 中,将模式从 From List 改为 ID。输入
auto。 - 连接一个工具子节点,例如 Calculator 工具或 HTTP Request 工具。
- 打开聊天窗口,发送一条测试消息。
模型请使用 ID 模式。列表模式会显示完整的 FreeLLMAPI 目录,其中也包含您暂时无法调用的模型。以下 ID 在 n8n 中很有用:
| 模型 ID | 用途 |
|---|---|
auto | 通用工作流。路由器会遵循您的回退链。 |
auto:fast | 分类、简短摘要及其他高频步骤 |
auto:smart | 必须进行规划或选择工具的智能体步骤 |
auto:reliable | 不能失败的定时工作流 |
auto:<profile> | 命名的回退链,例如只包含支持工具调用模型的回退链 |
对于智能体步骤,回退链中只保留支持工具调用的模型。以下免费模型目前支持工具调用:
| 模型 | 免费提供方 | 上下文 | 免费额度(最优惠) | 工具 | 视觉 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 请求/分钟 1 req/min per model | 是 | 否 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 是 | 是 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 请求/分钟 50 请求/天 Shared rate limit | 是 | 否 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 请求/分钟 250 请求/天 70,000 令牌/分钟 ~6M | 是 | 是 |
显示 10 个(共 109 个匹配的免费模型)。 查看所有模型.
数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。
第 3 步:处理免费套餐的限制
一个对 500 个条目进行循环的工作流会发送 500 次请求。免费套餐会限制每分钟和每天的请求数。FreeLLMAPI 会统计每个密钥的配额,并在收到 429 错误时切换到下一个提供商。当链中的所有密钥都已达到限制时,网关会返回带有 Retry-After 标头的 429。
设置以下选项,使短暂的限制不会中断工作流:
| 位置 | 设置 | 值 |
|---|---|---|
| OpenAI Chat Model,Options | Max Retries | 3 到 5 |
| OpenAI Chat Model,Options | Timeout | 长提示词请设为 60000 毫秒或更高 |
| 节点设置(齿轮图标) | Retry On Fail | 开启 |
| 节点设置 | Max. Tries | 3 |
| 节点设置 | Wait Between Tries (ms) | 5000 或更高 |
| Loop Over Items 节点 | Batch Size | 使用小批次,并在批次之间设置 Wait 节点 |
添加更多提供商的密钥,可提高每天的总请求数。下表列出了当前目录中每个提供商的免费限制。
| 提供方 | 免费模型 | 每分钟最大请求数 | 每天最大请求数 | 每分钟最大令牌数 | 每月令牌数(单个模型) | 最强的免费模型 |
|---|---|---|---|---|---|---|
| ElectronHub | 84 | - | - | - | $0.25/week shared recurring credit | Qwen3.8 Flash (ElectronHub)qwen3.8-flash |
| Cloudflare Workers AI | 39 | - | - | - | ~5-10M | Qwen 3.8 27B (Cloudflare Workers AI)@cf/qwen/qwen3.8-27b |
| Inferbase | 38 | - | - | - | 5,000 requests/month; 100 requests and $0.50 usage/day shared | DeepSeek V4 Flash (fp8) (Inferbase)deepseek-v4-flash:fp8 |
| AI Horde | 31 | - | - | - | Ongoing volunteer queue; availability varies | Gemma 4 31B Heretic (AI Horde)koboldcpp/gemma-4-31B-it-heretic |
| ACLIDE | 29 | - | - | - | €20/month shared internal usage credits · no card | Qwen3.8 Max (ACLIDE)qwen/qwen3.8-max:free |
| Google AI Studio | 21 | 15 | 1,000 | 250,000 | ~3M | Gemini 3.8 Flashgemini-3.8-flash |
| Api.Airforce | 20 | 1 | 1,000 | - | free · 1,000 req/day · 1 req/min | gpt-oss-20b (Api.Airforce)gpt-oss-20b |
| NVIDIA NIM | 19 | 40 | - | - | free · 40 RPM | GLM 5.3 Flash (NV)z-ai/glm-5.3-flash |
| Cohere | 17 | 20 | 33 | - | ~1-2M | Command A+ (05-2026)command-a-plus-05-2026 |
| DreamPrompting | 14 | 100 | 5,000 | - | free · 500K tokens/day · 5,000 req/day | Gemini 3.1 Flash-Litegoogle/gemini-3.1-flash-lite |
数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。
使用 HTTP Request 节点
您也可以使用通用的 HTTP Request 节点调用 FreeLLMAPI。当您需要 OpenAI 节点未显示的参数,或需要查看响应标头时,请使用此方法。
- 方法:
POST - URL:
http://host.docker.internal:3001/v1/chat/completions - 标头:
Authorization,值为Bearer <unified-key> - Body 内容类型:JSON
JSON 请求体
{
"model": "auto:fast",
"messages": [
{"role": "system", "content": "Classify the ticket as billing, bug or other. Reply with one word."},
{"role": "user", "content": "{{ $json.ticket_text }}"}
],
"temperature": 0
}回答位于 choices[0].message.content 中。响应标头 X-Routed-Via 显示应答的提供商和模型。如果路由器切换了提供商,X-Fallback-Attempts 会显示失败尝试的次数。
故障排除
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 凭据测试因连接错误而失败 | localhost 指向 n8n 容器 | 使用 host.docker.internal 或共享的 Docker 网络 |
| 错误 401 | 密钥错误 | 重新粘贴统一密钥 |
| 模型列表有数百个条目 | 列表模式会读取完整目录 | 使用 ID 模式并输入 auto |
| 智能体会回答,但从不使用工具 | 所选模型不支持工具调用 | 使用上表中的模型,或使用包含支持工具调用模型的配置方案 |
| 长循环中出现错误 429 | 所有密钥都已达到限制 | 添加提供商,使用较小的批次,并开启 Retry On Fail |
| 节点超时 | 长提示词触发了较慢的免费模型 | 增加 Timeout,或使用 auto:fast |
常见问题
我可以在 n8n 的 OpenAI 节点中使用自定义 Base URL 吗?
可以。n8n 中的 OpenAI 凭据包含 Base URL 字段。请将其设置为以 /v1 结尾的兼容 OpenAI 的 URL,例如 FreeLLMAPI 的 http://localhost:3001/v1。
n8n 有可用的免费 LLM API 吗?
有。免费提供商套餐可通过 OpenAI 凭据在 n8n 中使用。FreeLLMAPI 将多个免费套餐汇集在一个密钥之后。每个套餐都有各自的请求限制。
哪个免费模型可用于 n8n 的 AI Agent 节点?
请使用支持工具调用的模型,因为 AI Agent 节点以 Tools Agent 方式运行。本页的表格列出了支持工具调用的免费模型。
如何避免 n8n 工作流因速率限制而失败?
在聊天模型节点上设置 Max Retries,在节点设置中开启 Retry On Fail,并以小批次处理条目。添加更多提供商的密钥,以提高每天的总数。
n8n Cloud 能否与自托管的 LLM 网关配合使用?
只有当网关具有公共 HTTPS 地址时才可以。n8n Cloud 无法访问您计算机上的 localhost。
相关指南
来源
- n8n source: OpenAI credential fields (API Key, Organization ID, Base URL) (检查于 20 November 2026)
- n8n docs: OpenAI Chat Model node (检查于 20 November 2026)
- n8n docs: AI Agent node (检查于 20 November 2026)
- n8n docs: node settings (Retry On Fail) (检查于 20 November 2026)
- FreeLLMAPI docs: REST API (routing strategies, response headers) (检查于 20 November 2026)