环境准备
在 n8n 中接入 AIHubMix 前，需满足以下条件：- 已部署可访问的 n8n 实例（n8n Cloud 或自托管版本均可）
- 工作区已启用 AI 节点（默认在 1.19 及以上版本中可用）
- 已在 aihubmix.com 完成账号注册，并在控制台创建 API 凭据
- 已记录如下两项配置参数：
- API Key：以
sk-开头的字符串 - Base URL：
https://aihubmix.com/v1
- API Key：以
官网
N8N 官网：http://n8n.io/配置教程
- 进入工作区，新增 Chat Model 节点，增加凭据。
- 填写名称、API Key 以及 Base URL 并保存。
- 选择新建的凭据，添加需要使用的模型，并关闭
Use Response API。
- 打开
Open Chat即可在 N8N 中使用 AIHubMix 的模型。
模型选择
凭据配置完成后，在节点参数区的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
- n8n 官网：n8n.io
- n8n 文档：docs.n8n.io