88API88API
使用指南AI 应用API 文档帮助支持

n8n - AI 自动化工作流平台

在 n8n 中通过 AI Agent 与 OpenAI Chat Model 接入 88API,并关闭 Responses API 完成兼容调用。

本教程固定使用 Chat Model 路线

主线为 AI Agent → OpenAI Chat Model,并关闭 Use Responses API。 不使用 OpenAI 应用节点的 “Message a model” 作为兼容接入示例。

n8n 可以把模型连接到触发器、Agent、工具和业务系统。本页依据 n8n OpenAI credential 文档OpenAI Chat Model 文档和当前官方源码整理。

使用前准备

  1. 登录 88API,创建 API Key,并确认余额充足。
  2. 确认 88API 的 https://88api.ai/v1/models 能返回当前账户可用模型。
  3. 准备一个当前稳定版本的 n8n 实例。

创建基础 AI 工作流

  1. 在 n8n 新建 Workflow。
  2. 添加 Chat Trigger
  3. 添加 AI Agent,并把 Chat Trigger 连接到 AI Agent。
  4. 在 AI Agent 的 Chat Model 端口点击加号,添加 OpenAI Chat Model 子节点。

n8n 官方文档中的 AI 工作流结构示例

创建 OpenAI 凭据

在 OpenAI Chat Model 中找到 Credential to connect with,选择创建新的 OpenAI credential,然后填写:

字段填写内容
API Key你的 88API API Key
Organization ID留空
Base URLhttps://88api.ai/v1
Add Custom Header关闭

n8n OpenAI credential 的 88API 配置示例

图中是在 n8n 官方真实界面底图上标出的填写顺序:输入 API Key、Organization ID 留空、Base URL 填写 https://88api.ai/v1、关闭 Custom Header,然后确认连接测试成功。

保存并测试连接。n8n 当前凭据测试会请求:

GET https://88api.ai/v1/models

因此“连接测试失败”首先应检查 Base URL、API Key 和 /v1/models 是否可访问。

选择模型并关闭 Responses API

回到 OpenAI Chat Model 子节点:

  1. Model 中选择 /v1/models 返回的模型。
  2. 如果下拉列表没有显示目标模型,把 Model 切换为 ID 模式,手动粘贴精确模型 ID。
  3. 找到 Use Responses API,将它关闭。

必须检查 Use Responses API

当前 OpenAI Chat Model 节点默认可能开启 Responses API。只有目标渠道明确支持 /v1/responses 时才能开启;本教程关闭它,使调用走兼容性更广的 /v1/chat/completions

不要把 Base URL 写成 /v1/chat/completions。节点会根据关闭后的协议自行追加 Chat Completions 路径。

执行与验证

  1. 保存 Workflow。
  2. 打开 Chat Trigger 的测试聊天窗口,发送一条简单文本。
  3. 确认 AI Agent 返回正常内容。
  4. 查看 AI Agent / OpenAI Chat Model 的执行日志,确认没有 404、401 或 HTML 错误页。
  5. 打开 88API 控制台使用日志,核对模型、时间和请求记录。

n8n AI Agent 通过 OpenAI Chat Model 返回结果的真实界面

为什么不以 OpenAI 应用节点为主线

n8n 的 OpenAI 应用节点包含文本、图片、视频、文件等多种操作,不同操作会访问不同 API 路径。凭据测试通过只证明 /v1/models 可用,不代表每一种操作都被目标网关实现。

n8n 官方仓库 issue #21651 曾记录:自定义 Base URL 的凭据测试成功,但旧版 OpenAI Node v2 的 “Message a model” 运行时返回 404;同一凭据在 AI Agent → OpenAI Chat Model 中可以工作。该 issue 已关闭,但它说明兼容教程应明确节点和协议边界。

验证清单

  • 使用的是 AI Agent 下的 OpenAI Chat Model 子节点。
  • Credential Base URL 为 https://88api.ai/v1
  • 凭据测试能够访问 /v1/models
  • Model 为 88API 返回的精确 ID。
  • Use Responses API 已关闭。
  • 测试对话返回文本,88API 使用日志有对应记录。

常见问题

凭据测试成功,运行时却返回 404

先确认使用的是 AI Agent → OpenAI Chat Model,并关闭 Use Responses API。不要直接改成某个猜测路径;检查执行日志中的实际 endpoint。

凭据测试无法通过

n8n 会调用 {Base URL}/models。Base URL 应为 https://88api.ai/v1,API Key 必须有权访问模型列表。

模型列表为空或没有目标模型

确认 /v1/models 返回成功。如果只是目标模型没有出现在下拉框,使用 Model 的 ID 模式手动填写精确模型 ID。

返回 401

编辑 OpenAI credential,重新粘贴 88API API Key。Organization ID 一般不需要填写,Custom Header 也应保持关闭。

Responses API 可以打开吗

只有当所选 88API 渠道已经实测支持 /v1/responses 时才打开。不同模型可能路由到不同渠道,因此一个模型可用不代表所有模型都可用。

可以直接使用图片、视频或 Files 操作吗

不能根据本教程推断这些操作兼容。它们不是 Chat Completions 路线,需要针对各自 endpoint、请求体和返回格式单独验证。

官方依据