展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
与DOI元数据审计不同,本例交付可真实解析和格式化的.bib及参考文献HTML。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"references": [
{
"id": "gao2026",
"type": "article",
"authors": [
"Gao, Ming",
"{apizt Labs}"
],
"title": "Practical API and JSON Workflows",
"year": "2026",
"journal": "Demo Notes"
},
{
"id": "de2025",
"type": "book",
"authors": [
"de la Cruz, Ana"
],
"title": "A Guide to XML",
"year": "2025",
"publisher": "Fictional Press"
}
]
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 保存两条原创书目信息
- 2. 调用API只提取给定字段
- 3. 为缩写和团体作者加BibTeX保护
- 4. 使用Pybtex真实解析并格式化HTML
- 5. 回查作者顺序和标题
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只处理给定原创虚构材料。只输出JSON,不补未提供的事实。输出entries数组,每条保留id/type/authors/title/year及journal或publisher,不添加DOI或网址。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只处理给定原创虚构材料。只输出JSON,不补未提供的事实。输出entries数组,每条保留id/type/authors/title/year及journal或publisher,不添加DOI或网址。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只处理给定原创虚构材料。只输出JSON,不补未提供的事实。输出entries数组,每条保留id/type/authors/title/year及journal或publisher,不添加DOI或网址。\n待处理合成材料:\n{\"references\": [{\"id\": \"gao2026\", \"type\": \"article\", \"authors\": [\"Gao, Ming\", \"{apizt Labs}\"], \"title\": \"Practical API and JSON Workflows\", \"year\": \"2026\", \"journal\": \"Demo Notes\"}, {\"id\": \"de2025\", \"type\": \"book\", \"authors\": [\"de la Cruz, Ana\"], \"title\": \"A Guide to XML\", \"year\": \"2025\", \"publisher\": \"Fictional Press\"}]}"
}
],
"temperature": 0,
"max_tokens": 1200,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:references.bib、references.html、result.json、checks.json。
workflow.py · 本例分支节选
original = case['input']['references']
entries = output.get('entries', [])
ck('书目ID与顺序没有改变', [r.get('id') for r in entries] == [r['id'] for r in original])
chunks = []
for r, orig in zip(entries, original):
ck('作者顺序与团体作者保留 ' + orig['id'], r.get('authors') == orig['authors'])
title = r.get('title', '')
ck('标题原文保留 ' + orig['id'], title == orig['title'])
protected = re.sub('\\b(API|JSON|XML)\\b', '{\\1}', title)
fields = {'author': ' and '.join(r.get('authors', [])), 'title': protected, 'year': r.get('year', '')}
for key in ['journal', 'publisher']:
if key in r:
fields[key] = r[key]
chunks.append('@' + r.get('type', 'misc') + '{' + r['id'] + ',\n' + ',\n'.join((' ' + k + ' = {' + v + '}' for k, v in fields.items())) + '\n}')
bib = '\n\n'.join(chunks)
(f / 'references.bib').write_text(bib)
parsed = parse_string(bib, 'bibtex')
ck('Pybtex真实回读条目数', len(parsed.entries) == 2)
ck('API大写保护保留', '{API}' in parsed.entries['gao2026'].fields['title'])
style = find_plugin('pybtex.style.formatting', 'plain')()
bibliography = style.format_bibliography(parsed)
writer = find_plugin('pybtex.backends', 'html')()
writer.write_to_file(bibliography, str(f / 'references.html'))
ck('HTML参考文献实际生成', (f / 'references.html').stat().st_size > 100)
result = {'keys': list(parsed.entries), 'engine': 'pybtex', 'protected_title': parsed.entries['gao2026'].fields['title']}
art += ['references.bib', 'references.html']5. 对照真实结果和检查表
实测2026-10-25T07:48:33.231154+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次9/9项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量419tokens;1份尝试记录的已知用量合计419。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 书目ID与顺序没有改变 | 通过 |
| 作者顺序与团体作者保留 gao2026 | 通过 |
| 标题原文保留 gao2026 | 通过 |
| 作者顺序与团体作者保留 de2025 | 通过 |
| 标题原文保留 de2025 | 通过 |
| Pybtex真实回读条目数 | 通过 |
| API大写保护保留 | 通过 |
| HTML参考文献实际生成 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 书目ID与顺序没有改变
- 结果
- 通过
- 实际检查
- 作者顺序与团体作者保留 gao2026
- 结果
- 通过
- 实际检查
- 标题原文保留 gao2026
- 结果
- 通过
- 实际检查
- 作者顺序与团体作者保留 de2025
- 结果
- 通过
- 实际检查
- 标题原文保留 de2025
- 结果
- 通过
- 实际检查
- Pybtex真实回读条目数
- 结果
- 通过
- 实际检查
- API大写保护保留
- 结果
- 通过
- 实际检查
- HTML参考文献实际生成
- 结果
- 通过
result.json · 原生处理后实际结果
{
"keys": [
"gao2026",
"de2025"
],
"engine": "pybtex",
"protected_title": "Practical {API} and {JSON} Workflows"
}6. 替换输入前,先确认这些边界
实际使用Pybtex读取和格式化BibTeX,不声称使用经典bibtex或LaTeX编译器。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 书目ID与顺序没有改变
- 作者顺序与团体作者保留 gao2026
- 标题原文保留 gao2026
- 作者顺序与团体作者保留 de2025
- 标题原文保留 de2025
- Pybtex真实回读条目数
- API大写保护保留
- HTML参考文献实际生成
常见问题
AI 参考文献 BibTeX 生成怎么开始?
保存两条原创书目信息按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
实际使用Pybtex读取和格式化BibTeX,不声称使用经典bibtex或LaTeX编译器。



