展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
参见本批TOPIC-RESEARCH.md同编号新增边界,原生小样与负例均独立交付。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"fixture": "程序生成合成热敏小票,金额末位彻底遮除"
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 由程序生成原创合成小票input.jpg,商家与货品清晰,部分金额像素被遮除;这不是现实褪色票据总体基准。
- 2. 只把该JPEG和转录要求送给apizt,不把本地绘制参数或被移除的金额原值放入文字提示。
- 3. 读取模型实际返回的merchant、item、total、needs_review;不可见金额位数应保留total=null并标记复核。
- 4. 对照图中DEMO MART和DEMO CUP核对可见字段,确认程序没有用推算或猜测补齐金额。
- 5. 保存transcription-review.json;把擅自填金额的输出作为拒绝负例,结果图展示未知状态而非伪造完整账目。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只输出JSON:merchant字符串、item字符串、total可为数字或null、needs_review布尔值。仅转录实际可见信息,金额有不可见位数时total必须null,needs_review为true,不能推算缺失数字。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只输出JSON:merchant字符串、item字符串、total可为数字或null、needs_review布尔值。仅转录实际可见信息,金额有不可见位数时total必须null,needs_review为true,不能推算缺失数字。"
},
{
"role": "user",
"content": [
{
"type": "text",
"text": "严格只输出单个JSON对象,不用代码围栏。只输出JSON:merchant字符串、item字符串、total可为数字或null、needs_review布尔值。仅转录实际可见信息,金额有不可见位数时total必须null,needs_review为true,不能推算缺失数字。\n只输出JSON:merchant字符串、item字符串、total可为数字或null、needs_review布尔值。仅转录实际可见信息,金额有不可见位数时total必须null,needs_review为true,不能推算缺失数字。"
},
{
"type": "image_url",
"image_url": {
"url": "[实际图片Base64;完整原始请求在资料包]",
"detail": "high"
}
}
]
}
],
"temperature": 0,
"max_tokens": 1536,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:transcription-review.json。
workflow.py · 本例分支节选
check('商家与货品按可见文字转录', output.get('merchant') == 'DEMO MART' and output.get('item') == 'DEMO CUP')
check('不可见金额位数不补猜', output.get('total') is None and output.get('needs_review') is True)
result = {'transcription': output, 'sourceSent': 'input.jpg', 'localGoldenNotSent': True, 'reviewReason': '金额部分像素被彻底移除,原数字不能由图像恢复'}
dump(artifact('transcription-review.json'), result)5. 对照真实结果和检查表
实测2026-10-25T07:54:36.927749+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次4/4项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量1290tokens;1份尝试记录的已知用量合计1290。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 商家与货品按可见文字转录 | 通过 |
| 不可见金额位数不补猜 | 通过 |
| 列出的原生产物实际存在 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 商家与货品按可见文字转录
- 结果
- 通过
- 实际检查
- 不可见金额位数不补猜
- 结果
- 通过
- 实际检查
- 列出的原生产物实际存在
- 结果
- 通过
result.json · 原生处理后实际结果
{
"transcription": {
"merchant": "DEMO MART",
"item": "DEMO CUP",
"total": null,
"needs_review": true
},
"sourceSent": "input.jpg",
"localGoldenNotSent": true,
"reviewReason": "金额部分像素被彻底移除,原数字不能由图像恢复"
}6. 替换输入前,先确认这些边界
程序遮除部分金额像素模拟不可辨认段;不是真实褪色票据总体基准。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 商家与货品按可见文字转录
- 不可见金额位数不补猜
- 列出的原生产物实际存在
常见问题
AI 小票 识别 不清晰怎么开始?
由程序生成原创合成小票input.jpg,商家与货品清晰,部分金额像素被遮除;这不是现实褪色票据总体基准。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
程序遮除部分金额像素模拟不可辨认段;不是真实褪色票据总体基准。


