展开本页目录
开始前准备什么
- 已运行的 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. 运行合成输入,核对发给模型的内容
G01 的 Quick Route 应替换为 apizt;G02 已正确,保持原句。
校验节点用本地字符串规则逐字检查,不以模型自述“通过”作为验收。
sample-input.json
[
{
"id": "G01",
"text": "请打开 Quick Route 控制台。",
"required": "apizt",
"forbidden": "Quick Route"
},
{
"id": "G02",
"text": "Open the apizt console.",
"required": "apizt",
"forbidden": "Quick Route"
}
]4. 查看本次原生结果
实测时间:2026-11-02T13:58:16.686850+00:00。请求模型:gpt-4o-mini;返回模型:gpt-4o-mini;HTTP 200;finish_reason=stop;输入 144、输出 37、合计 181 tokens。
在成功执行记录中双击“校验字段与结果”,右侧 Output 应能看到实际字段。下方 JSON 是本次真实导出结果,便于与截图放大对照;不是预填的期望答案。
actual-result.json
[
{
"id": "G01",
"建议文本": "请打开 apizt 控制台。",
"需人工确认": "是"
},
{
"id": "G02",
"建议文本": "Open the apizt console.",
"需人工确认": "是"
}
]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 或发送通知?
不会。模板只有一次文字请求及本地校验、导出节点,结果需人工确认。


