展开本页目录
开始前准备什么
- 自己的 Flowise 部署；本页测试版本 3.1.4。
- 自己的 apizt Key 和 gpt-4o-mini 权限；Key 只存客户端私密配置。
- 先使用本页合成输入，不上传真实业务资料。
- 确认版本
- 设置凭据
- 限制用量
- 发送短文本
- 核对原始结果
先下载样例，再完成自己的首次调用
示例不含密钥。API 按实际用量计费；下载和点击不代表调用成功。
导入后自行选中凭据，或合并到已有环境。
包含真实输入、输出和验证限制。
先确认版本、验证范围和维护状态
官方已宣布停止维护。官网 sunset 页面说明 2026-07-29 冻结代码、2026-08-31 结束维护。本页保留给现有部署做兼容核对，不作为新生产系统的选型建议。
本次官方 Docker 3.1.4 默认 SQLite 启动遇到 this.db.exec is not a function；改用官方支持的 DATABASE_TYPE=postgres，在隔离 PostgreSQL 17 数据库完成验证，没有修改厂商登录或会话代码。新实例管理员密码由使用者自行设置。
公开工作流不含凭据、Key、聊天记录或固定回答。导入后需要自行创建凭据并选中。测试只覆盖 LLM Chain 文字输入输出；没有验证 Agent、RAG、工具或迁移后的生产稳定性。
原生聊天记录没有提供 token 统计，本页不按字符数估算账单。256 是每次输出上限，不是实际消费量；实际费用以 apizt 账户日志为准。
1. 设置自己的 API 地址、模型和输出上限
在现有 Flowise 的 Chatflows 中新建画布，Settings → Load Chatflow，选择本页下载的 flowise-text-chatflow.json。应出现“apizt 文字模型”“中文输入提示”“输出文字结果”三个节点和中文便签。
进入 Credentials → Add Credential → OpenAI API。Credential Name 自定，OpenAI Api Key 填自己的 apizt Key 原文，不加 Bearer 前缀。返回画布，刷新后在模型的 Connect Credential 中选中该凭据。
Base URL、文字模型与单次输出上限设置。2026-11-02，隔离本地部署 Flowise 3.1.4，合成文字样例。
2. 导入文字链并选中凭据
Model Name 填 gpt-4o-mini，Temperature=0。打开 Additional Parameters：BasePath=https://api.apizt.com/v1、Max Tokens=256、Timeout=30000、Streaming 关闭；BaseOptions 留空。保存画布。
中文节点连线与选中凭据。2026-11-02，隔离本地部署 Flowise 3.1.4，合成文字样例。
3. 先核对 QR_OK，再运行中文合成工单
点击右上角 chat，先发送“接入测试：只回复 QR_OK，不要添加其他内容。”，收到 QR_OK 后，再发送下方合成工单。不要连续重试或连接其他工具。
sample-input.txt
只输出一个 JSON 对象，包含 category 和 summary。category 只能是 billing、bug、feature；summary 用中文，不超过 30 字。合成工单：测试订单发生重复扣款，请核对账单。
原生聊天返回 QR_OK。2026-11-02，隔离本地部署 Flowise 3.1.4，合成文字样例。
4. 核对真实结果，下载原始记录
本次两条提示词均由原生客户端通过 apizt 发起请求。连通性回复为 QR_OK；第二条 JSON 的 category 为 billing，摘要保留重复扣款、核对账单的信息。
以下内容来自原生存储记录，不是预置响应。合成输入不含真实客户资料；实际业务仍需人工复核。
actual-result.json
[
{
"role": "userMessage",
"content": "接入测试：只回复 QR_OK，不要添加其他内容。",
"createdDate": "2026-11-02T15:11:24.025"
},
{
"role": "apiMessage",
"content": "QR_OK",
"createdDate": "2026-11-02T15:11:30.049"
},
{
"role": "userMessage",
"content": "只输出一个 JSON 对象，包含 category 和 summary。category 只能是 billing、bug、feature；summary 用中文，不超过 30 字。合成工单：测试订单发生重复扣款，请核对账单。",
"createdDate": "2026-11-02T15:11:42.111"
},
{
"role": "apiMessage",
"content": "{\n \"category\": \"billing\",\n \"summary\": \"测试订单重复扣款，请核对账单。\"\n}",
"createdDate": "2026-11-02T15:11:47.309"
}
]
真实中文工单分类结果。2026-11-02，隔离本地部署 Flowise 3.1.4，合成文字样例。
5. 失败时检查凭据与协议，不盲目重试
401 先检查 Key 是否有效、凭据是否选中。这里 API Key 字段填原始 Key，不加 Bearer；不要把 n8n 的 Header Auth 填法直接复制过来。
404 检查 Base URL 是否已含 /v1，不再追加 /chat/completions；重复路径可能无法匹配。429 先查看 apizt 日志中的额度、模型权限和路由，不直接判断为模型不存在。
能保存配置并不代表调用成功。先通过短文本，再评估业务任务；遇到异常停止，不增加视频、语音或向量调用来排查文字链问题。
怎样确认已经完成
- 原生界面选择正确的模型、地址和凭据。
- QR_OK 精确匹配，第二次 JSON 能解析且 category 为 billing。
- 没有上传业务资料或启用额外模型调用。
常见问题
还需要第三方模型平台账号吗？
本例使用自己的 apizt Key。客户端的本地管理员账户与模型提供方账户是不同的配置。
配置文件可以直接覆盖原来的文件吗？
不要覆盖。先备份、按当前版本合并字段；公开下载不含 Key 和登录凭据。
这是否证明 Agent 或知识库可用？
本页只验证两个短文本输入。Agent、知识库、工具调用和嵌入需要单独验收。