客户端接入 · n8n

n8n 接入 HardysAPI:改凭据里的 Base URL

n8n 的 OpenAI 节点支持自定义 Base URL,一个凭据就能驱动所有节点:分类、摘要、翻译、结构化抽取。

准备:控制台创建的密钥,以及 模型价格 里挑好的模型名。

配置步骤

  1. 左侧 Credentials → Add Credential,搜索 OpenAI;
  2. API Key 粘贴 sk-...;
  3. 展开 Base URL(部分版本在「Options」里),填 https://hardysapi.com/v1;
  4. 保存后测试连接;
  5. 在工作流里添加 OpenAI → Message a Model 节点,Resource 选 Text,Model 填模型名。

模型下拉里没有你的模型

n8n 的模型下拉是内置列表,新版在 Model 字段支持 Expression 模式, 切到表达式直接写字符串即可:

Expression 写法javascript
{{ "claude-sonnet-4-5" }}

常见坑

  • 404:Base URL 少了 /v1;n8n 在此基础上拼 /chat/completions;
  • 批处理任务余额掉得快:循环节点里每条数据都发一次请求,先把模型换成低价档,或先用 Limit 节点限制条数跑通流程;
  • 结构化输出报错:部分模型不支持 response_format,改用提示词要求输出 JSON 再用 Code 节点解析。

验证

绕过 n8n 直接验证bash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5-mini","messages":[{"role":"user","content":"ping"}]}'

常见问题

n8n 的 OpenAI 凭据里 Base URL 在哪?

在凭据编辑页的 Base URL 字段(部分版本折叠在 Options 里),填 https://hardysapi.com/v1。

n8n 工作流怎么控制成本?

把高频节点换成低价模型,循环前加 Limit 限制条数,并对重复输入做缓存或去重。