LLM 与学术检索 API 的三条实测行为
下面三条是 2026 年 8 月 15 日实测得到的接口行为。三条的共同点是: 失败的表现位置和真正的原因不在同一处,因此按报错信息排查会指向错误的方向。
1. Gemini:模型名 gemini-2.0-flash 在 v1beta 返回 404
gemini-2.5-flash 在 v1beta generateContent 端点正常返回;gemini-2.0-flash 在同一端点返回 HTTP 404。
POST https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent?key=...- 实测结果
gemini-2.5-flash→ HTTP 200,正常返回内容;gemini-2.0-flash→ HTTP 404 Not Found。- 为什么容易误判
- 同一个 API key、同一个请求体,只改模型名,一个成功一个 404。说明 404 来自模型名解析而非鉴权。
2. arXiv:http 端点 301 重定向,curl 不加 -L 得到 0 字节
arXiv export API 的 http:// 端点返回 301;curl 不加 -L 会得到 0 字节文件。
curl -sSL -G 'https://export.arxiv.org/api/query' --data-urlencode 'search_query=...'- 实测结果
- 不加
-L:HTTP 301 size 0,写出 0 字节文件。加-L并改用 https:HTTP 200 size 91596,返回 37 条记录。 - 为什么容易误判
- 失败不是报错退出,而是静默产出空文件,下一步解析才炸,报 'no element found: line 1, column 0' —— 错误信息指向解析器,真正原因在上一步的重定向。
3. OpenAlex:filter=type:article 会排除 preprint
OpenAlex /works 加 filter=type:article 会排除 preprint,对 2023 年后出现的新概念几乎检索不到有效结果。
https://api.openalex.org/works?search=...&filter=type:article- 实测结果
- 同一检索短语,OpenAlex 加
type:article返回 3255 条,人工检查前 6 条与主题无关; arXiv API 同一短语返回 37 条,全部直接相关。 - 为什么容易误判
- 同一个检索词,OpenAlex 返回的条目与主题无关;arXiv API 返回大量直接相关的论文。新领域的成果主要以 preprint 形式存在,被 type:article 过滤掉了。
适用范围
三条结论的有效期受各接口版本影响。模型名可用性会随发布计划变化; 重定向策略和过滤语义相对稳定。遇到与本页不符的情况,以实际运行结果为准。