目前服务部署在单台小机器上,全站检索约 50 次/秒、ask 约 20 个并发;请控制并发(建议 ≤ 5),收到 429 按 Retry-After 退避。 详情 →

论文

概览

arXiv 全文,按章节结构化,每节带 TLDR;旁边还有 bioRxiv / medRxiv。

状态
live
文档 id
arxiv_id 如 2409.05591
引用格式
[arXiv:2409.05591]
更新于
2026-09

常用调用

找论文POST /v1/papers/search {"query": "speculative decoding", "filters": {"publish_at": {"gte": "2024"}, "categories": ["cs.CL"]}}
读一篇GET /v1/papers/read/2409.05591 → 默认 level=detail:元数据 + 每节 TLDR 和 token 数;再按需 level=full&section=<name> 或 level=full
直接问POST /v1/papers/ask {"query": "DEER 在 HumanEval 上加速多少", "effort": "low"} → 带 [arXiv:…] 引用的答案;effort = low | medium | high

问题本身比参数重要。要具体——"what compression ratio does KV cache eviction report on LongBench" 远好于 "kv cache";要数字就直接问数字。中文可以直接问。年份、会议、分类、作者、机构、最低引用数这些限定写进 filters。结果不对就换个问法——调高 effort 只增加阅读轮数。

细则
  • level=full&section= 的名字要和 level=detail 里 sections[].name 完全一致(含编号,如 '1. Introduction')。

读

GET/v1/papers/read/{arxiv_id}
三档深浅,不传就是 detail。免费样例:2409.05591。

三档

深浅credits返回
brief1标题、TLDR、关键词、日期、引用数、GitHub。~300 tok
detail (默认)2元数据 + 章节地图(每节 name / tldr / token 数)+ 总 token 数
full5全文 markdown

侧面

同一份文档的另一个侧面,与 level 二选一。

侧面credits返回
trending1X/Twitter 热度信号

参数

参数类型说明
arxiv_id (path) 必填 string 文档 id(arxiv_id)。
level brief · detail · full= detail 读多深。
extra trending 改读某个侧面,与 level 二选一。
format json · md · html= json 响应形态。
section string (level = full:只读这一节)
characters integer= 10000 (level = full:只读前 N 字)

示例

{ "domain": "papers", "id": "2409.05591", "level": "detail", "view": "head", "data": { … } | "text": "…", "token_count": 1834, "meta": { … } }
旧写法 GET /v1/papers/doc/{id}?view=… 仍然可用。

批量读

POST/v1/papers/read
最多 50 个 id,同一档。查不到的 id 返回 error: "not_found",不扣费。

参数

参数类型说明
ids 必填 string[] 文档 id 列表。
level brief · detail · full= detail 所有 id 共用的档。
extra trending 改读某个侧面。

示例

{ "domain": "papers", "level": "detail", "docs": [ { "id": "…", "data": { … } }, { "id": "…", "error": "not_found" } ], "meta": { … } }

Facets

GET/v1/papers/facets?field={field}
某个过滤字段的合法值,agent 不用猜;预聚合字段带计数,声明的枚举没有。免费、不需要 key。

参数

参数类型说明
field 必填 source · categories · venues 有 facets 的过滤字段。
limit integer= 50 最多返回多少个值。

示例

{ "domain": "papers", "field": "…", "values": [ { "value": "…", "count": 3120 } ], "meta": { … } }

问registered key+ /stream

POST/v1/papers/ask
混合检索 + 读章节 + 带真实 [arXiv:id] 引用作答;/stream 为 NDJSON。effort low / medium / high 对应 50 / 100 / 200 credits。加 /stream 走 NDJSON,第一个事件一定是 billing。首个 answer_delta 之前失败会退款。

参数

参数类型说明
query 必填 string 1–2000 字符。问得具体;要数字就直接问数字。
effort low · medium · high= low 检索轮数,也决定价格:50 / 100 / 200 credits。套餐限制最高档。
verbose bool= false 返回工具调用轨迹(流式时多 tool_call / tool_result / thinking 事件)。
top_k integer= 10 预取候选数。
stream_answer bool= true 仅流式:false 时只发一个 answer 事件。
max_rounds integer 0–8,覆盖 effort 预设。
force_answer_after number 秒;强制切入作答阶段。
max_answer_tokens integer= 4096 触顶时置 answer_truncated。
language string 回答语言,默认跟随 query。

示例

{ "answer": "… [arXiv:2409.05591] …", "sources": [ … ], "stats": { "rounds": 1, "elapsed_s": 6.2, "answer_truncated": false }, "coverage"?: { … }, "meta": { "credits": { "charged": 50, … } } }
引用是真的——answer 里的每个 id 都存在于本垂域(格式 [arXiv:2409.05591])。sources 是召回集,不是引用列表。answer_truncated 表示不完整。