Flowise - 可视化 LLM 工作流平台
在 Flowise 中使用 ChatOpenAI Custom 接入 88API，并完成自定义模型、基础地址、对话测试和故障排查。
推荐接入方式
88API 的模型不一定出现在 Flowise 的预设列表中，因此本教程使用 ChatOpenAI Custom。它允许手动填写模型名称和 OpenAI 兼容基础地址。
Flowise 可以通过拖拽节点构建 Chatflow 和 Agentflow。本页依据 Flowise ChatOpenAI 官方文档、ChatOpenAI 与 ChatOpenAI Custom 当前源码整理。所有界面图均来自 Flowise 官方文档仓库。
使用前准备
- 登录 88API，创建 API Key，并确认余额充足。
- 从 88API 模型列表确认要使用的精确模型 ID。
- 准备一个可正常使用的 Flowise 实例。
添加 ChatOpenAI Custom
- 新建一个 Chatflow。
- 打开节点列表，在 Chat Models / LangChain 模型节点中找到 ChatOpenAI Custom。
- 将节点拖到画布。
如果使用普通 ChatOpenAI 节点，模型必须出现在它的预设列表中；自定义模型名则应使用 ChatOpenAI Custom。
创建 88API 凭据
在 ChatOpenAI Custom 节点中打开 Connect Credential，选择 Create New。
在 ChatOpenAI credential 中填写：
| 字段 | 填写内容 |
|---|---|
| API Key | 你的 88API API Key |
保存凭据后返回节点。API Key 由凭据管理器保存，不要把它写进提示词、节点名称或导出的公开流程中。
填写模型与基础地址
- Model Name：填写 88API 返回的精确模型 ID。
- 展开 Additional Parameters。
- Base Path：填写
https://88api.ai/v1。 - Base Options：保持为空。
图中是在 Flowise 官方界面底图上标出的 88API 实际填写值：BasePath 填写 https://88api.ai/v1，BaseOptions 保持为空。
Base Path 只填到 /v1
不要填写 https://88api.ai/v1/chat/completions。Flowise
会根据节点操作自行拼接请求路径。
Base Options 什么时候填写
Base Options 会作为 JSON 默认请求头传给 OpenAI SDK。88API 正常使用 Bearer API Key 时不需要额外请求头，因此保持为空即可。如果服务端明确要求附加请求头，内容必须是合法 JSON；错误格式会在发送请求前直接失败。
连接并运行 Chatflow
- 添加 Conversation Chain 或当前版本中等价的基础对话链节点。
- 将 ChatOpenAI Custom 的输出连接到该链的 Chat Model 输入。
- 保存 Chatflow。
- 打开聊天测试面板，发送一条纯文本消息。
- 确认 Flowise 返回正常文本，并在 88API 控制台使用日志中找到对应调用。
建议先用最小流程验证普通对话，再加入 Memory、Retriever、Tools 或 Agent 节点。这样遇到错误时，可以区分是模型接入问题还是工作流编排问题。
验证清单
- ChatOpenAI credential 已保存，节点不再提示缺少凭据。
- Model Name 与 88API 模型 ID 完全一致。
- Base Path 为
https://88api.ai/v1。 - Base Options 为空，或内容是服务端明确要求的合法 JSON。
- Chatflow 测试能返回文本，88API 使用日志有对应记录。
多模态与工具调用限制
- Flowise 官方文档明确说明，界面中的 Image Upload 只适用于 LLMChain、Conversation Chain、ReAct Agent 和 Conversational Agent。
- 图片是否能被理解，还取决于目标 88API 模型是否支持视觉输入。
- Tools、Structured Output 和 reasoning 内容依赖 LangChain 节点与上游返回格式，不是设置 Base Path 后就一定可用。
- Flowise 3.0.11 曾有 Agentflow v2 Structured Outputs 问题，相关 官方 issue 已关闭；当前教程不把旧问题描述成必现故障。
常见问题
Model Name 下拉框里没有需要的模型
使用 ChatOpenAI Custom，在 Model Name 中手动粘贴 /v1/models 返回的精确 ID，不要在普通 ChatOpenAI 的预设列表里反复查找。
返回 401
重新创建或编辑 ChatOpenAI credential，确认 API Key 完整且没有空格、换行。Base Path 不负责鉴权。
返回 404
确认 Base Path 为 https://88api.ai/v1，且没有追加 /chat/completions。再核对模型 ID 是否存在。
请求发送到 OpenAI 官方地址
展开 Additional Parameters，确认 Base Path 已实际保存。只创建自定义 API Key 凭据而没有设置 Base Path，仍可能使用节点默认地址。
普通聊天正常，但 Agent 或工具失败
先回到纯文本 Conversation Chain 验证；再逐个添加工具。确认所选模型支持标准 OpenAI 工具调用结构，不要仅根据模型名称推断能力。