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

Flowise - 可视化 LLM 工作流平台

在 Flowise 中使用 OpenAI Custom Model 接入 88API,并完成自定义模型、基础地址、对话测试和故障排查。

推荐接入方式

88API 的模型不一定出现在 Flowise 的预设列表中,因此本教程使用 OpenAI Custom Model(Flowise 3.0.x 及更早版本名为 ChatOpenAI Custom)。它允许手动填写模型名称和 OpenAI 兼容基础地址。

Flowise 可以通过拖拽节点构建 Chatflow 和 Agentflow。

使用前准备

  1. 登录 88API,创建 API Key,并确认余额充足。
  2. 从 88API 模型列表确认要使用的精确模型 ID。
  3. 准备一个可正常使用的 Flowise 实例。

添加 OpenAI Custom Model

Flowise 只有英文界面,下文截图均为英文界面(本页以 Flowise 3.1.4 为准)。

  1. 新建一个 Chatflow。
  2. 点击画布左上角的 + 打开节点列表(LangChain → Chat Models),或在搜索框输入 custom,找到 OpenAI Custom Model(Flowise 3.0.x 及更早版本名为 ChatOpenAI Custom)。
  3. 将节点拖到画布,在 Model Name 中填写 88API 的精确模型 ID,例如 gpt-6.1-sol。

如果使用普通 OpenAI 节点,模型只能从它的预设列表中选择;自定义模型名应使用 OpenAI Custom Model。

创建 88API 凭据

在 OpenAI Custom Model 节点中打开 Connect Credential,选择 Create New,在弹出的 OpenAI API 凭据中填写:

字段填写内容
CREDENTIAL NAME88API 或便于识别的名称
OpenAI Api Key你的 88API API Key

Flowise OpenAI API 凭据窗口

点击 Add 保存后返回节点。API Key 由凭据管理器保存,不要把它写进提示词、节点名称或导出的公开流程中。

填写模型与基础地址

  1. Model Name:填写 88API 返回的精确模型 ID。
  2. 展开 Additional Parameters。
  3. Base Path:填写 https://api.88api.ai/v1。
  4. Base Options:保持为空。

Flowise Additional Parameters 中的 Base Path

图中标出了 88API 的填写值:Base Path 填写 https://api.88api.ai/v1,Base Options 保持为空。

Base Path 只填到 /v1

不要填写 https://api.88api.ai/v1/chat/completions。Flowise 会根据节点操作自行拼接请求路径。

Base Options 什么时候填写

Base Options 会作为 JSON 默认请求头传给 OpenAI SDK。88API 正常使用 Bearer API Key 时不需要额外请求头,因此保持为空即可。如果服务端明确要求附加请求头,内容必须是合法 JSON;错误格式会在发送请求前直接失败。

连接并运行 Chatflow

  1. 添加 Conversation Chain 节点,以及一个 Memory 节点(如 Buffer Memory),Conversation Chain 的 Memory 为必填项。
  2. 将 OpenAI Custom Model 的输出连接到 Conversation Chain 的 Chat Model 输入,将 Buffer Memory 连接到 Memory 输入。
  3. 保存 Chatflow。
  4. 点击右上角的聊天按钮打开测试面板,发送一条纯文本消息。
  5. 确认 Flowise 返回正常文本,并在 88API 控制台使用日志中找到对应调用。

Flowise Chatflow 连线与聊天测试

图中 ① 为已选择的 88API 凭据,② 为 88API 模型的回复。

建议先用最小流程验证普通对话,再加入 Retriever、Tools 或 Agent 节点。这样遇到错误时,可以区分是模型接入问题还是工作流编排问题。

验证清单

  • OpenAI API 凭据已保存,节点不再提示缺少凭据。
  • Model Name 与 88API 模型 ID 完全一致。
  • Base Path 为 https://api.88api.ai/v1。
  • Base Options 为空,或内容是服务端明确要求的合法 JSON。
  • Chatflow 测试能返回文本,88API 使用日志有对应记录。

多模态与工具调用限制

  • 图片上传需要在 Chat Model 节点的 Additional Parameters 中打开 Allow Image Uploads。该选项只在普通 OpenAI 节点中提供,而普通 OpenAI 节点只能选择预设模型;OpenAI Custom Model 节点没有图片上传选项,因此使用 88API 的自定义模型 ID(如 deepseek-v4.1-flash)时,Flowise Chatflow 暂不能发送图片。
  • 需要识图时,建议改用支持自定义视觉模型的其他客户端,例如 Cherry Studio。
  • Tools、Structured Output 和 reasoning 内容依赖 LangChain 节点与模型返回格式,不是设置 Base Path 后就一定可用。
  • Flowise 3.0.11 曾有 Agentflow v2 Structured Outputs 问题,相关 官方 issue 已关闭。

常见问题

Model Name 下拉框里没有需要的模型

使用 OpenAI Custom Model,在 Model Name 中手动粘贴 /v1/models 返回的精确 ID,不要在普通 OpenAI 节点的预设列表里反复查找。

返回 401

重新创建或编辑 OpenAI API 凭据,确认 API Key 完整且没有空格、换行。Base Path 不负责鉴权。

返回 404

确认 Base Path 为 https://api.88api.ai/v1,且没有追加 /chat/completions。再核对模型 ID 是否存在。

请求发送到 OpenAI 官方地址

展开 Additional Parameters,确认 Base Path 已实际保存。只创建自定义 API Key 凭据而没有设置 Base Path,仍可能使用节点默认地址。

普通聊天正常,但 Agent 或工具失败

先回到纯文本 Conversation Chain 验证;再逐个添加工具。确认所选模型支持标准 OpenAI 工具调用结构,不要仅根据模型名称推断能力。

官方依据