> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt > Use this file to discover all available pages before exploring further. # n8n > 在 n8n 中接入 AIHubMix：让这个工作流自动化平台在节点中用单个 API key 调用模型。 n8n 是一款开源的工作流自动化平台，支持以可视化节点方式编排数据流转、API 调用与 AI 任务。自 2023 年起，n8n 在其节点库中陆续引入 AI Agent、Chat Model、Vector Store 等 LLM 原生组件，使工作流可直接调用大语言模型完成内容生成、分类、信息抽取、多轮决策等任务。本文档介绍如何在 n8n 中以凭据（Credential）形式接入 AIHubMix，并在 Chat Model 节点中调用所需模型。 ## 环境准备 在 n8n 中接入 AIHubMix 前，需满足以下条件： * 已部署可访问的 n8n 实例（n8n Cloud 或自托管版本均可） * 工作区已启用 AI 节点（默认在 1.19 及以上版本中可用） * 已在 [aihubmix.com](https://aihubmix.com/) 完成账号注册，并在控制台创建 API 凭据 * 已记录如下两项配置参数： * **API Key**：以 `sk-` 开头的字符串 * **Base URL**：`https://aihubmix.com/v1` ### 官网 N8N 官网：[http://n8n.io/](http://n8n.io/) ### 配置教程 1. 进入工作区，新增 Chat Model 节点，增加凭据。 n8n 2. 填写名称、API Key 以及 Base URL 并保存。 n8n 3. 选择新建的凭据，添加需要使用的模型，并关闭 `Use Response API` 。 n8n 4. 打开 `Open Chat` 即可在 N8N 中使用 AIHubMix 的模型。 n8n n8n ## 模型选择 凭据配置完成后，在节点参数区的 `Model` 字段中可指定具体调用的大模型。 常用模型与适用场景对应关系如下： * **GPT-5.5**：OpenAI 当前旗舰模型，适用于复杂推理、长链路 Agent 决策、多步骤代码生成等高难度任务。 * **GPT-5.4**：OpenAI 上一代旗舰，与 OpenAI 生态兼容性最广，适合作为存量项目的稳定升级路径。 * **Claude Opus 4.7**：Anthropic 当前旗舰，在长文档理解、复杂指令跟随、合规审查等场景表现优异。 * **Claude Sonnet 4.6**：综合性价比之选，适用于内容生成、客服对话、邮件起草等高频生产任务，建议作为工作流的默认模型。 * **DeepSeek V4 Flash**：响应延迟最短、单位成本最低，适用于分类、抽取、翻译、关键词提取等高并发场景。 在节点的 `Model` 字段中输入对应模型名（例如 `claude-sonnet-4-6`、`deepseek-v4-flash`）即可生效。如该字段提供下拉选项但未包含目标模型，可切换至 `Expression` 模式手动输入模型名。 *** ## 典型应用场景 n8n 与 AIHubMix 结合后，可承载多种基于大模型的自动化工作流。以下为生产环境中较为常见的几类用法。 ### 邮件自动分类与回复 通过 Email Trigger 节点接收新邮件，将正文传入 OpenAI Chat Model 节点，由 Claude Sonnet 4.6 完成意图分类与回复草稿生成，再经审批节点确认后由 SMTP 节点发出。该工作流将客服团队的初筛工作量减少约 70%。 ### 文档批量处理与摘要 由 Google Drive 或 Notion 触发器监听新文档，将内容分块后逐段调用 DeepSeek V4 Flash 完成摘要生成，结果写回知识库。利用 DeepSeek V4 Flash 的低成本特性，可在不增加显著支出的前提下完成大规模文档处理。 ### AI Agent 多步任务编排 使用 n8n 的 AI Agent 节点配合 Claude Opus 4.7 作为决策模型，结合 HTTP Request、Database、Code 等工具节点，构建可自主完成"查询、分析、决策、执行"全流程的代理。该模式适用于运维巡检、报表生成、数据治理等需要多步推理的复杂任务。 ### 多模态内容生成 将文本输入传入 GPT-5.5 生成文案，再通过 AIHubMix 的图像生成接口生成配图，最终由 n8n 写入内容管理系统。整条链路在同一组凭据下完成，无需维护多套上游配置。 *** ## 生产环境实践建议 ### 凭据分级管理 建议按环境（开发、预发布、生产）与用途（核心业务、批量任务、实验性工作流）创建多组凭据。AIHubMix 控制台支持创建多个 API Key 并独立设置额度上限，结合 n8n 的凭据隔离能力，可有效控制单一凭据泄漏或超支带来的影响范围。 ### 成本可观测 n8n 的 Execution 日志记录了每次节点运行的耗时与状态，但不直接显示 token 用量与费用。建议在工作流中增加一个 Code 节点，从 Chat Model 节点的输出中解析 `usage` 字段并写入数据库或监控系统。AIHubMix 控制台的账单明细可作为对账依据。 ### 模型降级链路 对于关键业务工作流，建议构建模型降级机制：主链路使用 Claude Opus 4.7 或 GPT-5.5，当节点报错或超时时由 IF 节点切换至 Claude Sonnet 4.6 或 DeepSeek V4 Flash 重试。该模式可在不影响业务连续性的前提下，最大化保障服务可用性。 ### 提示词模板复用 n8n 支持通过 Set 节点或全局变量管理提示词模板。建议将提示词集中维护，避免在多个工作流中复制粘贴。模型升级或迭代提示词时只需修改一处。 *** ## 常见问题 **节点调用返回 404 Not Found**\ 通常由 Base URL 缺失 `/v1` 后缀引起。确认凭据中的 Base URL 为 `https://aihubmix.com/v1`，并重新保存凭据。 **节点调用返回 401 Unauthorized**\ 请依次确认：API Key 是否完整复制（不含前后空格）；AIHubMix 账户余额是否充足 **OpenAI Chat Model 节点不支持目标模型名称**\ n8n 的节点下拉列表仅预置部分 OpenAI 官方模型。如需使用 Claude、DeepSeek 等模型，可将 `Model` 字段切换至 `Expression` 模式后手动输入完整模型名。 **自托管 n8n 实例无法访问 AIHubMix**\ 请确认 n8n 部署所在服务器的出网策略已允许访问 `aihubmix.com` 域名。对于运行在容器内的 n8n，亦需确认容器网络配置未限制外部 HTTPS 请求。 *** ## 参考资源 * AIHubMix ：[aihubmix.com](https://aihubmix.com/) * n8n 官网：[n8n.io](https://n8n.io/) * n8n 文档：[docs.n8n.io](https://docs.n8n.io/) 最新更新日期：2026年5月13日