配置 n8n 的 OpenAI 凭证与模型端点

创建凭证和专用 Key

为 n8n 创建一把 Router One Key 并设置 maxSpend 消费上限；每个环境各用一把 Key，例如测试和生产工作流分开，两者的花费就能在控制台 → 日志里分开看。定时触发和 Webhook 触发的工作流都在无人值守时运行，这个上限就是硬性止损。在 n8n 里打开 Credentials → Add credential → OpenAI，或者在任意 OpenAI 节点的凭证下拉里新建。表单里有 API Key、Organization ID（可选，留空）、Base URL（默认 https://api.openai.com/v1），以及一个 Add Custom Header 开关，接 Router One 不需要它。保存时，n8n 会用 GET {Base URL}/models 测试凭证；Router One 只在 Key 有效时才响应这个请求，所以测试通过就说明 Key 和地址都对。

把 n8n 配置到 Router One base URL

把 Base URL 改成 https://api.router.one/v1，粘贴 Key。然后在节点里选中这份凭证。OpenAI Chat Model 节点会带着 Key 请求 GET {Base URL}/models 加载模型列表；Base URL 不是 api.openai.com 时，它会列出目录中的全部 ID，也包括图像生成模型，所以请选择聊天模型，或者把 Model 字段切换到 ID，粘贴 /models 上的精确 ID：

Base URL

https://api.router.one/v1

# n8n → Credentials → Add credential → OpenAI
API Key:   sk-your-router-one-key
Base URL:  https://api.router.one/v1
# Organization ID: leave blank · Add Custom Header: off
# OpenAI Chat Model node (version 1.3): Model = an exact chat ID from /models
# Use Responses API: off for Claude or Gemini IDs; on only if the model page lists /v1/responses
# Embeddings: a separate credential for a provider that serves embeddings

OpenAI Chat Model 节点的 Use Responses API 开关

OpenAI Chat Model 节点有 1 到 1.3 几个版本，现在新加的节点是 1.3 版。这个版本有一个 Use Responses API 开关，默认打开（按 n8n 2.41.3 中该节点的源码），所以新节点发出的是 POST /v1/responses。在 Router One 上，这个端点只适用于模型详情页列出 POST /v1/responses 的 ID：GPT 系列、DeepSeek 与 Grok 对话模型。Claude 系列 ID 在这里会收到 HTTP 400 invalid_request_error，消息为 model '<id>' must be called via /v1/messages or /v1/chat/completions，Gemini 的 ID 在这里同样不提供。关掉开关，节点就改发 Chat Completions，这个端点服务目录中的全部聊天模型。开关打开时，节点还会显示 Built-in Tools（网页搜索、文件搜索、代码解释器）。对 Router One 在 /v1/responses 上原生服务的 ID，这些托管工具字段会按原样转发并计量，但 Router One 自己不执行工具。文件搜索需要 vector store ID，而 Router One 不提供创建它们所需的文件或向量库 API，所以请保持文件搜索关闭；网页搜索或代码解释器请先用一次真实请求确认再依赖。1.3 之前版本的节点没有这个开关。

会改变请求内容的选项

OpenAI Chat Model 节点的选项会写进每一次请求。Timeout 默认 60,000 毫秒，同时作用于响应头和响应体；Max Retries 默认 2。长生成可能超过一分钟，慢模型请调大 Timeout；另外，每次重试都是控制台 → 日志里一条独立的请求，而在这之前 Router One 已经换同一模型的其他线路重试过。Reasoning Effort 选项只在模型名以 gpt-5、o1 或 o3 及之后的前缀开头时显示，所以对 openai/gpt-5.5 这类带厂商前缀的目录 ID 不会出现。想发送它，可以在 Extra Body 里写 {"reasoning_effort": "low"}，n8n 会把它合并进请求体。对 Claude 系列 ID，Router One 不会把 reasoning_effort 转换为 thinking 设置；Claude Opus 5.5 例外，会映射到 output_config.effort（none 与 minimal 记为 low）。其他模型可能忽略它，或以 400 拒绝请求。如果 400 错误点名了 temperature、top_p 或其他参数，请去掉对应选项；那是模型拒绝了这个值，与凭证无关。

AI Agent 与工具调用

AI Agent 节点通过连接的聊天模型调用工具，所以请选详情页标明支持工具调用的 ID。如果网关返回 HTTP 400，错误信息含 has no chat candidate that supports requested capabilities: tool_calling，说明所选 ID 不支持工具调用，请换模型。OpenAI Chat Model 节点发送的工具定义不带 strict 标志。Agent 的每一轮迭代都是一次独立的模型请求，所以一次执行可能在控制台 → 日志里产生多条记录：每次工具调用一轮，再加上最终回答。除非 Agent 可能用到的每个模型详情页都列出 /v1/responses，否则请关闭 Use Responses API。

OpenAI 节点的各个动作调用什么

OpenAI 节点（默认 2.3 版）使用同一份凭证，但调用固定的端点。Text → Message a Model 发往 /v1/responses，所以只适用于这个端点服务的 GPT 系列、DeepSeek 与 Grok 对话模型；Claude 或 Gemini 的 ID 请改用 Basic LLM Chain 或 AI Agent，接上关闭 Use Responses API 的 OpenAI Chat Model 子节点。这个动作的后台模式请保持关闭：Router One 会以 400 拒绝 background: true，而该模式下 n8n 用来轮询的 GET /v1/responses/{id} 在 Router One 上也没有路由。Image → Generate an Image 发往 /v1/images/generations，它的模型搜索会列出 ID 含 gpt-image 的目录模型，例如 gpt-image-2；每张图按模型详情页上的固定单张价格计费。音频、文件和 Assistant 相关动作调用的端点 Router One 都不提供，会返回 404。

Embeddings 与向量库

Embeddings OpenAI 子节点同样使用凭证里的 Base URL，所以用这份凭证时，它会把 POST /v1/embeddings 发到 Router One，而 Router One 没有 embeddings 端点，会返回 404。向量库工作流请另建一份 OpenAI 凭证，填 OpenAI 自己的 Base URL 和 Key，或者改用其他 embeddings 供应商的节点，接到向量库的 embedding 输入上。根据检索结果作答的聊天模型，仍然可以是用 Router One 凭证的 OpenAI Chat Model。

到控制台 → 日志核对一次执行

在编辑器里手动运行一次工作流，然后打开控制台 → 日志。每一次模型调用都是一条独立的请求，记在精确的目录 ID 下，显示 tokens、费用、状态、总耗时，以及产生过输出的流式请求的首字延迟（TTFT）；一次 Agent 运行会按模型轮次各记一条。按时间和模型与 n8n 的执行记录对照。401 说明 Key 不被接受；402 请检查钱包余额或 Key 的 maxSpend。404 且错误信息要求 base URL 以 /v1 结尾，说明凭证的 Base URL 少了 /v1；400 且错误信息指出应调用的端点，说明 Use Responses API 开关与模型不匹配。

n8n 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 n8n 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

n8n 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在请求日志里核对 n8n 的调用

先在 n8n 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

常见问题