文献检索接口
学术文献检索API:中文/英文检索词检索中英文学术文献库,去重后返回文献条目(标题、作者、期刊、DOI、摘要、引文等),按次计费,与查重共用检测余额,失败自动全额退款。
文献检索接口
更新日期:2026-10-27。变更:英文文献检索恢复,scope 支持 chinese(中文文献)/ english(英文文献),english_query 字段重新启用;同日中文检索结果新增规范引文等字段(见第 6 节字段表)。 接口前缀 /api/v1/literature,所有示例与代码实现逐字段核对。
提供学术文献检索:提交中文或英文检索词,平台检索中英文学术文献库,跨库去重后返回文献条目(标题、作者、期刊、年份、DOI、摘要、规范引文、链接等)。英文文献以国际英文期刊为主(含中国机构主办的英文期刊)。一次检索一笔固定费用,按次计费;与论文查重 / AIGC 检测共用「检测余额」账户,余额查询与说明见查重/AIGC检测接口文档。
检索为异步流程:提交订单立即返回订单号并预扣本次费用,检索完成后轮询订单详情获取完整结果;检索失败或超时自动全额退回检测余额。绝大多数订单在 1 分钟内完成,个别情况(个别检索耗时较长、平台自动重试)可能延长到几分钟,建议以 5-10 秒间隔轮询。
1. 接入信息
| 项目 | 说明 |
|---|---|
| Base URL | https://api.llmapi.fit |
| 认证方式 | Authorization: Bearer YOUR_API_KEY(与降重、查重接口同一把密钥,控制台「APIKEY」页获取) |
| 请求格式 | JSON |
| 响应格式 | JSON |
错误响应有两种格式:
- 业务错误(HTTP 非 2xx):
{"code": "错误码", "message": "错误说明"},错误码总表见第 7 节 - 鉴权失败(HTTP 401):
{"detail": "无效的接口密钥或登录凭证"}(无 code 字段)
2. 计费与余额
- 按次计费:一次检索订单 = 一笔固定费用,金额以下单响应的
fee_yuan为准(平台可能调价,每笔订单按下单时的单价) - 下单即预扣:提交订单时从检测余额全额预扣;检索失败、超时或平台无法取得结果时自动全额退回(退款后订单
fee_yuan为 0) - 共享余额:与查重 / AIGC 检测共用检测余额,互不隔离。余额查询
GET /api/v1/check/balance(字段说明见查重/AIGC检测接口文档),充值在平台控制台完成 - 检索正常完成即收费(即使命中 0 条);检索失败不收费
- 平台不提供下单幂等:网络超时后重试
POST /orders会生成新订单并再次计费,调用方应自行避免重复提交
3. 接口速览
| 方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
| POST | /api/v1/literature/orders | 提交检索订单 | 需要 |
| GET | /api/v1/literature/orders/{order_no} | 订单详情(含检索结果) | 需要 |
4. 提交检索订单
POST /api/v1/literature/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"scope": "chinese",
"query": "大语言模型 幻觉"
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| scope | string | 否 | 检索范围:chinese(中文文献)/ english(英文文献),省略时默认 chinese |
| query | string | 视情况 | 检索词,1-500 字符:scope=chinese 必填;scope=english 时可用它代替 english_query |
| english_query | string | 视情况 | 英文检索词,1-500 字符:scope=english 时与 query 至少提供一个,同时提供时优先 english_query |
英文检索请求体示例:
{
"scope": "english",
"english_query": "hallucination in large language models"
}
请求体不允许未知字段(HTTP 422)。检索词会自动去掉首尾空白;scope=chinese 时即使传入 english_query 也会被忽略。
响应:
{
"code": "success",
"order_no": "LTR20261006153012A1B2C3",
"status": "running",
"fee_yuan": 0.5
}
| 字段 | 说明 |
|---|---|
| order_no | 平台订单号,以此查询结果 |
| status | 订单状态,见第 6 节 |
| fee_yuan | 本次预扣金额(元) |
余额不足时返回 HTTP 402 {"code": "insufficient_balance", "message": "检测余额不足,请先充值"},订单不创建。
5. 检索词怎么写(实践建议)
- 推荐「主题 + 切入点」的 2~3 个概念词组合,用空格分隔,例如
大语言模型 幻觉。只给一个宽泛词(如"人工智能")命中噪音大;堆太多词容易把结果压到只剩几条甚至 0 条。 - 空格表示"并且":检索串里的多个词默认要求全部命中,这是最稳妥的用法。
- 同义词、近义词方向分多次检索:接口按"一次一个检索串"设计;想覆盖"幻觉""虚构"等多个说法,请分别提交订单(每单独立计费)。不建议使用
SU=、AND/OR等专业检索式——平台将检索串原样提交给文献库,此类语法的效果不作承诺。 - 命中 0 条时先减词:概念组合越窄越容易空结果,优先减少概念词数量再试。
- 检索串上限 500 字符,常规 10~20 字的组合即可满足。
6. 订单详情(获取结果)
GET /api/v1/literature/orders/LTR20261006153012A1B2C3
Authorization: Bearer YOUR_API_KEY
响应(订单 completed 后出现 result 字段):
{
"order_no": "LTR20261006153012A1B2C3",
"status": "completed",
"scope": "chinese",
"query": "大语言模型 幻觉",
"english_query": null,
"entry_count": 23,
"fee_yuan": 0.5,
"created_at": "2026-10-06 15:30:12",
"completed_at": "2026-10-06 15:30:41",
"fail_reason": null,
"result": {
"request_id": "5f0c1e2a-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "complete",
"scope": "chinese",
"entries": [ { "...": "文献条目,字段见下表" } ],
"count": 23,
"language_counts": { "zh": 23 }
}
}
english_query 为英文检索词:英文检索订单为实际使用的英文检索词,中文检索订单为 null。
订单状态 status(平台状态机):
| 取值 | 含义 |
|---|---|
| running | 检索执行中,继续轮询 |
| completed | 完成,result 字段携带完整检索结果 |
| failed | 失败(已自动全额退款,fee_yuan 为 0),fail_reason 为原因 |
result 内是本次检索的结果明细,其中 status 表示检索完成度(complete 全部成功 / partial 部分成功 / failed 全部失败),与订单状态是两层信息。
result 字段:
| 字段 | 说明 |
|---|---|
| request_id | 本次检索的请求 ID |
| entries | 去重合并后的文献列表,元素字段见下表 |
| count | 去重后的条数 |
| language_counts | 返回条目按语种计数(zh / en) |
文献条目 entries[] 字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 文献 ID |
| title | string | 标题 |
| title_en | string | 英文标题(可为空字符串) |
| authors | string | 作者 |
| institutions | string | 机构 |
| journal | string | 期刊名 |
| year | int 或 null | 出版年 |
| volume / issue / pages | string | 卷、期、页码 |
| article_number | string | 文章号(部分期刊使用) |
| doi | string | DOI |
| url / pdf_url | string | 详情页和 PDF 链接 |
| abstract / abstract_en | string | 摘要及英文摘要 |
| keywords | string | 关键词 |
| issn | string | ISSN |
| publish_date | string | 出版日期 |
| fund | string | 基金信息 |
| cited_count | int 或 null | 被引数 |
| language | string | 语种代码 zh / en / und(未知) |
| cite | string | GB/T 7714 格式规范引文全文 |
| cite_mla / cite_apa | string | MLA / APA 格式引文 |
| type | string | 文献类型(如:期刊) |
注:cite、cite_mla、cite_apa、type 为 2026-10-27 新增字段,仅部分文献条目携带;无引文的条目该字段为空字符串、null 或不出现(历史订单),调用时按「字段可能缺失」处理即可。中文检索与英文检索单次各约返回 40 条。
真实条目示例(2026-10-27 生产环境实际返回,abstract、fund 等长文本以 …… 截短,其余字段逐字保留):
中文文献条目(带规范引文):
{
"id": "JSYJ20260908002",
"title": "医学视觉大语言模型幻觉分类与治理综述",
"title_en": "",
"authors": ["彭琳", "吴逸凡", "张国龙", "程春雷", "汪宇"],
"institutions": [],
"journal": "计算机应用研究",
"year": 2026,
"volume": "", "issue": "", "pages": "", "article_number": "",
"doi": "10.19734/j.issn.1001-3695.2026.05.0146",
"url": "https://kns.cnki.net/kcms2/article/abstract?v=txIpKU2KNMoOR2Yg6XvE5OZH9zq2nIpB1eDkRAkunSNcFI4ywbE9CBduP-IMFHTV2AG6wYVK9-nXgIWkuKSLstXQrCB2Wm1jL6tK2gGyipVLkX1qXDFaPjxUIaGgwGX3X0Lam8MNgDp-1rOl7wAeKrAhO1dEmooAUvaVNz9U4qyeWJi8F_63QA==",
"pdf_url": "",
"abstract": "医学视觉大语言模型(medical large vision-language models,Med-LVLMs)普遍存在幻觉现象,即模型存在对医学影像的错误感知和推理……(完整摘要原文)",
"abstract_en": "",
"keywords": [],
"issn": "",
"publish_date": "2026-09-09 13:43",
"fund": "",
"cited_count": null,
"language": "zh",
"cite": "彭琳,吴逸凡,张国龙,等.医学视觉大语言模型幻觉分类与治理综述[J/OL].计算机应用研究,1-16[2026-10-27].https://doi.org/10.19734/j.issn.1001-3695.2026.05.0146.",
"cite_mla": "彭琳, et al.\"医学视觉大语言模型幻觉分类与治理综述.\"计算机应用研究 doi:10.19734/j.issn.1001-3695.2026.05.0146.",
"cite_apa": "彭琳,吴逸凡,张国龙,程春雷 & 汪宇.医学视觉大语言模型幻觉分类与治理综述.计算机应用研究,1-16.https://doi.org/10.19734/j.issn.1001-3695.2026.05.0146.",
"type": "期刊"
}
中文文献条目(不带规范引文,cite 系列为空字符串,但 doi 仍可能有值):
{
"id": "7202575086",
"title": "大语言模型幻觉检测方法综述",
"title_en": "",
"authors": ["李自拓", "孙建彬", "陈广州", "方馨悦", "崔瑞靖", "田植良", "黄震", "杨克巍"],
"institutions": ["国防科技大学系统工程学院", "国防科技大学计算机学院", "并行与分布计算全国重点实验室(国防科技大学)"],
"journal": "计算机研究与发展",
"year": 2026,
"volume": "63", "issue": "1", "pages": "123-146", "article_number": "",
"doi": "10.7544/issn1000-1239.202550069",
"url": "https://qikan.cqvip.com/Qikan/Article/Detail?id=7202575086",
"pdf_url": "",
"abstract": "近年来,大语言模型(large language models,LLMs)在自然语言处理(natural language processing,NLP)等领域取得了显著进展……(完整摘要原文)",
"abstract_en": "",
"keywords": ["幻觉检测", "大语言模型", "事实一致性", "文本生成", "自然语言处理"],
"issn": "1000-1239",
"publish_date": "2026-01-01",
"fund": "国家自然科学基金项目(72471238);国家自然科学基金重点项目(72231011)……(完整基金信息)",
"cited_count": 12,
"language": "zh",
"cite": "", "cite_mla": "", "cite_apa": "", "type": ""
}
英文文献条目(scope=english 返回,三种规范引文齐全):
{
"id": "SJMD9A2975FAB4A9C2DDCCA929993C259128",
"title": "Mitigating Hallucinations in Finance-Based Multi-Agent Large Language Model Systems",
"title_en": "",
"authors": [],
"institutions": [],
"journal": "Electronics",
"year": 2026,
"volume": "", "issue": "", "pages": "", "article_number": "",
"doi": "",
"url": "https://kns.cnki.net/kcms2/article/abstract?v=txIpKU2KNModvdlS5CT9OUiPrbZ5Ty3AbAdJS-1-c80i38DF96GnI3LYlYq4ym-LjDn9uZZIAFRMZJspVtgUYxZHHfs5GIEkvGMlMTohoAmE-76ImuvkqipJGtTN7VePBqvpXCgZK-rPWzGfz2d-Ob-18N9azNOSTNoapSqQpM9l-L62yynTSB_N6S_ozBVkf62OnDZJqLTC5kLp9PYFVg==",
"pdf_url": "",
"abstract": "大型语言模型越来越多地用于金融问答,但它们容易产生幻觉内容。在这项研究中,我们提出了一种用于幻觉检测和缓解的多信号框架……(完整摘要原文)",
"abstract_en": "",
"keywords": [],
"issn": "",
"publish_date": "2026-09-28",
"fund": "",
"cited_count": null,
"language": "en",
"cite": "Nagpal R ,Usua U ,Simons K , et al.Mitigating Hallucinations in Finance-Based Multi-Agent Large Language Model Systems[J].Electronics,2026,15(19):4456-4456.DOI:10.3390/ELECTRONICS15194456.",
"cite_mla": "Rashmi Nagpal, et al.\"Mitigating Hallucinations in Finance-Based Multi-Agent Large Language Model Systems.\"Electronics 15.19(2026):doi:10.3390/ELECTRONICS15194456.",
"cite_apa": "Rashmi Nagpal,Unyimeabasi Usua,Kailey Simons,Sabrina Queipo,Amar Gupta & Vishal Gossain.(2026).Mitigating Hallucinations in Finance-Based Multi-Agent Large Language Model Systems.Electronics,15(19),4456-4456.https://doi.org/10.3390/ELECTRONICS15194456.",
"type": "外文期刊"
}
7. 错误码总表
| HTTP | code | 说明 |
|---|---|---|
| 401 | -(detail 格式) | 无效的接口密钥或登录凭证 |
| 402 | insufficient_balance | 检测余额低于单次单价,订单未创建 |
| 404 | not_found | 订单不存在(或不属于当前密钥) |
| 404 | service_unavailable | 文献检索服务未开放/未配置价格 |
| 400 | invalid_query | scope 非法(支持 chinese / english),或检索词缺失、超过 500 字符 |
| 422 | -(FastAPI 校验结构) | 请求体不是合法 JSON、含未知字段(含已停用的 english_query)等 |
订单内的失败(已建单后退回)不走上表:订单状态为 failed,费用已退,原因见 fail_reason(如检索失败、检索超时)。
8. 快速接入(Python 完整示例)
import time
import requests
BASE = "https://api.llmapi.fit"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}
# 第 1 步:提交检索订单(下单即预扣,失败自动全额退回)
resp = requests.post(f"{BASE}/api/v1/literature/orders", headers=HEADERS, json={
"scope": "chinese",
"query": "大语言模型 幻觉",
}, timeout=30).json()
order_no = resp["order_no"]
# 英文检索:scope 用 "english",检索词放 english_query
# resp = requests.post(f"{BASE}/api/v1/literature/orders", headers=HEADERS, json={
# "scope": "english", "english_query": "hallucination in large language models",
# }, timeout=30).json()
# 第 2 步:轮询订单详情,completed 后直接取 result
for _ in range(60):
detail = requests.get(f"{BASE}/api/v1/literature/orders/{order_no}", headers=HEADERS, timeout=30).json()
if detail["status"] != "running":
break
time.sleep(5)
if detail["status"] == "completed":
for entry in detail["result"]["entries"]:
print(entry.get("year"), entry.get("title"), entry.get("doi"))
else:
print("检索失败(已退款):", detail["fail_reason"])