展开本页目录
开始前准备什么
- 已运行的 n8n;本次核验版本为 2.16.0。
- 自己的 apizt Key,以及可用的 gpt-4o-mini 模型权限。
- 使用本页合成样例首次验收。更换业务资料后,需要同步修改提示词和校验断言。
- 导入中文模板
- 选择私密凭据
- 执行合成样例
- 校验并导出
- 人工确认
先下载样例,再完成自己的首次调用
示例不含密钥。API 按实际用量计费;下载和点击不代表调用成功。
不含 Key、凭据 ID 或预填执行结果。
包括样例范围、字段检查和费用控制。
1. 导入工作流,先核对任务范围
在 n8n 右上角更多操作中选择 Import from File,导入本页的 workflow.json。画布应依次显示“手动开始 → 准备中文样例 → apizt 文字请求 → 校验字段与结果 → 导出待确认 CSV”。
用一条合成销售线索核对人数、未给出的预算和内部跟进草稿。没有接入真实表单或发送邮件。
模板默认关闭,不含凭据和固定执行结果。先保留样例;不要直接接入生产触发器或批量业务资料。
2. 单独保存 Key,限制单次输出
双击“apizt 文字请求”,Authentication 选择 Generic Credential Type,Generic Auth Type 选择 Header Auth。新建或选择自己的凭据,Name 填 Authorization,Value 填 Bearer、一个空格和自己的 Key。
请求地址为 https://api.apizt.com/v1/chat/completions。Key 只保存在 n8n 凭据中,不填进 JSON 请求体、便签或公开导出文件。
“准备中文样例”内指定 gpt-4o-mini,max_tokens=600、stream=false,关闭自动重试。每次有效执行一次文字请求;模板免费,API 使用量另计费。
3. 运行合成输入,核对发给模型的内容
合成线索中的人数为 8;预算没有提供,模型原始字段必须为 null。
CSV 为便于人工阅读,把 null 显示成“待确认”。跟进草稿仅在内部使用,不发送邮件。
sample-input.json
[
{
"id": "L01",
"text": "示例公司甲想给 8 人客服团队接入知识库,预算未确定,需要下周演示。"
}
]4. 查看本次原生结果
实测时间:2026-11-02T13:57:52.000605+00:00。请求模型:gpt-4o-mini;返回模型:gpt-4o-mini;HTTP 200;finish_reason=stop;输入 132、输出 41、合计 173 tokens。
在成功执行记录中双击“校验字段与结果”,右侧 Output 应能看到实际字段。下方 JSON 是本次真实导出结果,便于与截图放大对照;不是预填的期望答案。
actual-result.json
[
{
"id": "L01",
"公司": "示例公司甲",
"人数": "8",
"预算": "待确认",
"缺项": "预算",
"跟进草稿": "中文内部草稿",
"需人工确认": "是"
}
]5. 下载 CSV,人工确认后再使用
在“导出待确认 CSV”的 Binary 输出中下载文件,核对 id、中文字段和“需人工确认”列。CSV 对以 =、+、@、- 开头的文本添加转义。
模型生成的摘要、建议或草稿仍可能有误。更换输入后,固定样例断言可能让工作流停止,这是保护行为;应先按新业务定义验收标准,再小批量测试。
失败时先检查状态,不连续重跑
401 检查 Header Auth 是否选中、Bearer 格式和 Key;429 核对账户额度、模型权限与路由,不能直接判断为模型不存在。DNS 或 TLS 错误先检查主机与容器网络。
HTTP 200 之后仍需检查完整文本和 JSON。若内容为空、夹带 Markdown 或字段不合约定,校验节点会停止,不生成伪成功结果。
首轮曾遇到 Gemini 非流式响应被拆成多个相同索引 choice 的异常;本组最终模板统一使用 gpt-4o-mini。异常调用另有用量记录,不能因为校验失败就当作零消费。
怎样确认已经完成
- 中文节点连线完整,凭据留在 n8n 凭据库中。
- HTTP 请求成功,记录数量、id 与业务校验均通过。
- 能够下载真实 CSV;人工核对模型输出,没有自动对外发送。
- 更换资料前重新审查脱敏范围、字段定义和断言。
常见问题
模板是中文的吗?
工作流名称、节点、便签、提示词、业务字段和说明优先中文。n8n 自身的界面标签及 API 字段保留原名,便于逐项配置。
可以直接处理我的真实资料吗?
先检查数据授权与脱敏范围,再修改输入和校验规则。本页验证的是公开的合成样例,不代表所有业务数据均能正确处理。
是否会发布 Issue 或发送通知?
不会。模板只有一次文字请求及本地校验、导出节点,结果需人工确认。



