文档 · 接入指南

n8n 接 TopxAI：带 Base URL 的 OpenAI 凭据

2026-09-19

在 n8n 里创建 OpenAI 凭据，Base URL 填 https://ai.topxea.com/v1 加 TopxAI 密钥，然后在 Chat Model 和 AI Agent 节点里用任意目录模型。

n8n 的 OpenAI 凭据有 Base URL 一栏，TopxAI 只需要这一项。Anthropic 凭据也有。

凭据

1. Credentials 里的 Add credential，再进 OpenAI。
2. API Key：自动路由的 TopxAI 密钥。Base URL：https://ai.topxea.com/v1。
3. 保存。n8n 会请求 /v1/models 来测试凭据。

Claude 走 Messages 接口：Anthropic 凭据，密钥相同，Base URL 填 https://ai.topxea.com。

节点

• OpenAI Chat Model（给 AI Agent、Basic LLM Chain 和其他 LangChain 节点用）：选这个凭据，再从 n8n 拉到的列表里选模型，或者手动输入 ID（claude-sonnet-5-5、gpt-6.1-sol、grok-4.7、kimi-k3、GLM-5.3-Abliterated）。
• OpenAI 节点的 Message a model 操作：同一凭据和 ID；Generate an image 用 gpt-image-2.5-sunburst 或 gpt-image-2.5-flare。
• Anthropic Chat Model：Anthropic 凭据，模型 claude-sonnet-5-5 或 claude-opus-5-5。

说明

• 调用 TopxAI 不提供的端点（音频转写、assistants、files）的操作会返回 404，这些继续用官方凭据。
• AI Agent 节点每一轮都带工具定义和记忆，全部按模型价格算输入。TopxAI 的用量日志能看到工作流的每一次调用。

不通时

• 401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
• curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

相关

• 接入你的 SDK
• 创建 API 密钥并选择线路
• curl 能跑通，工具里却报错
• 常见错误响应
• Dify 接 TopxAI：OpenAI-API-compatible 供应商
• LangChain 接 TopxAI：带 base URL 的 ChatOpenAI 和 ChatAnthropic
• Claude Sonnet 5.5 API pricing
• GPT-6.1 Sol API pricing

上一页：Dify 接 TopxAI：OpenAI-API-compatible 供应商 · 下一页：llm 命令行接 TopxAI：extra-openai-models.yaml

其他语言：English