展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14；系统与Node依赖以README为准。
- 离线重放无需Key；新请求使用自己的apizt Key，先核对模型权限和当前价格。
- 原创合成材料，不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放；包含完整失败尝试与本地检查，不含Key。
1. 核对本例材料与目标文件
参见本批TOPIC-RESEARCH.md同编号新增边界，原生小样与负例均独立交付。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留；本地核对答案不发送给模型。
input.json（节选）
{
"as_of": "2026-10-25",
"cards": [
{
"id": "K1",
"text": "试用期为7天。",
"expires": null
},
{
"id": "K2",
"text": "演示模板共3份。",
"expires": null
},
{
"id": "K3",
"text": "旧试用期为3天。",
"expires": "2026-09-30"
},
{
"id": "K4",
"text": "资料包可离线打开。",
"expires": null
},
{
"id": "K5",
"text": "需要新结果时才调用API。",
"expires": null
}
]
}
实际输入、原始文件和本例操作约束的浏览器截图
2. 按顺序完成这项具体操作
本次实际使用Python 3.14，依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理；只有显式--live才发新请求。
- 1. 准备K1—K5原创知识卡，给旧试用期K3设置2026-09-30到期日，其他四张卡保留现行7天、3份模板、离线和显式API调用事实。
- 2. 按2026-10-25过滤过期卡片，检查prepared-input.json没有K3，再将四张现行卡交给apizt写四句口播。
- 3. 要求每句同时返回text和sources，按句建立来源映射，不能给无依据的新事实随意挂一个来源ID。
- 4. 核对四句、有效来源以及7天/3份/离线/API等关键事实，生成spoken-script.md和sentence-sources.csv。
- 5. 从CSV逐句返回原卡片复核，过期K3仍保留在本地原始材料中，方便解释排除理由；来源链接检查不替代全部语义审阅。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只输出JSON：sentences数组，每项text、sources来源ID数组。用四句口语介绍现行信息，每句对应一个给定卡片，不编造优惠和效果；保留7天、3份、离线和显式调用信息。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json（图片Base64省略，原文件在下载包）
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象，不要Markdown代码围栏，不要解释。只输出JSON：sentences数组，每项text、sources来源ID数组。用四句口语介绍现行信息，每句对应一个给定卡片，不编造优惠和效果；保留7天、3份、离线和显式调用信息。"
},
{
"role": "user",
"content": "任务约束（只输出JSON对象，不用代码围栏）：\n只输出JSON：sentences数组，每项text、sources来源ID数组。用四句口语介绍现行信息，每句对应一个给定卡片，不编造优惠和效果；保留7天、3份、离线和显式调用信息。\n待处理合成材料：\n{\"cards\": [{\"id\": \"K1\", \"text\": \"试用期为7天。\", \"expires\": null}, {\"id\": \"K2\", \"text\": \"演示模板共3份。\", \"expires\": null}, {\"id\": \"K4\", \"text\": \"资料包可离线打开。\", \"expires\": null}, {\"id\": \"K5\", \"text\": \"需要新结果时才调用API。\", \"expires\": null}]}"
}
],
"temperature": 0,
"max_tokens": 1536,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支，需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物：sentence-sources.csv、spoken-script.md。
workflow.py · 本例分支节选
sentences = output.get('sentences', [])
valid = {'K1', 'K2', 'K4', 'K5'}
check('恰好四句并逐句有有效来源', len(sentences) == 4 and all((r.get('sources') and set(r['sources']) <= valid for r in sentences)))
check('过期K3不在模型输入', 'K3' not in json.dumps(prepared))
joined = ''.join((r.get('text', '') for r in sentences))
check('现行关键事实保留', '7' in joined and '3' in joined and ('离线' in joined) and ('API' in joined))
write_csv(artifact('sentence-sources.csv'), [{'sentence': r.get('text', ''), 'source_ids': '|'.join(r.get('sources', []))} for r in sentences])
artifact('spoken-script.md').write_text('\n\n'.join((r.get('text', '') for r in sentences)))
result = {'sentences': sentences, 'expiredExcluded': ['K3'], 'auditScope': 'checks source linkage and required facts, not general factual entailment'}5. 对照真实结果和检查表
实测2026-10-25T07:54:02.622006+00:00，HTTP200；请求gemini-2.5-flash-lite，返回gemini-2.5-flash-lite。本次5/5项检查通过，指本例执行及验收机制通过，不代表所有模型字段零误差。
最后一次返回用量374tokens；1份尝试记录的已知用量合计374。失败记录保留，用量缺失不按0计，本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 恰好四句并逐句有有效来源 | 通过 |
| 过期K3不在模型输入 | 通过 |
| 现行关键事实保留 | 通过 |
| 列出的原生产物实际存在 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 恰好四句并逐句有有效来源
- 结果
- 通过
- 实际检查
- 过期K3不在模型输入
- 结果
- 通过
- 实际检查
- 现行关键事实保留
- 结果
- 通过
- 实际检查
- 列出的原生产物实际存在
- 结果
- 通过
result.json · 原生处理后实际结果
{
"sentences": [
{
"text": "试用期有7天哦。",
"sources": [
"K1"
]
},
{
"text": "演示模板一共是3份。",
"sources": [
"K2"
]
},
{
"text": "这个资料包支持离线打开。",
"sources": [
"K4"
]
},
{
"text": "只有显式调用API才能获取新结果。",
"sources": [
"K5"
]
}
],
"expiredExcluded": [
"K3"
],
"auditScope": "checks source linkage and required facts, not general factual entailment"
}
本例实际产物与原始响应的浏览器截图；本地检查和模型答案分开记录
6. 替换输入前，先确认这些边界
公开材料为原创合成小样。API模型阶段与本地处理分别验收；通过结构和来源检查不代表通用事实准确率。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误；检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 恰好四句并逐句有有效来源
- 过期K3不在模型输入
- 现行关键事实保留
- 列出的原生产物实际存在
常见问题
AI 知识卡片 口播文案怎么开始？
准备K1—K5原创知识卡，给旧试用期K3设置2026-09-30到期日，其他四张卡保留现行7天、3份模板、离线和显式API调用事实。按本页顺序继续，先用下载包离线重放，再替换自己的材料。
网页试跑和下载包有什么区别？
网页只复跑模型字段，不生成全部原生文件；资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗？
公开材料为原创合成小样。API模型阶段与本地处理分别验收；通过结构和来源检查不代表通用事实准确率。