论文
概览
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§ion=<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§ion= 的名字要和 level=detail 里 sections[].name 完全一致(含编号,如 '1. Introduction')。
检索
POST
/v1/papers/search混合检索,每条命中一张卡片。2 credits。免费样例:
transformer。过滤字段
| 字段 | 类型 · op | 含义 |
|---|---|---|
| authors | keyword · eq any | 作者名,任一命中,并影响排序 |
| orgs | keyword · eq any | 机构名,任一命中,并影响排序 |
| categories | keyword · eq anycs.AI · cs.AR · cs.CC · cs.CE · cs.CG · cs.CL …共 117 个,/facets 可列全 | arXiv 分类,如 cs.CL |
| publish_at | datetime · range | 发表日期区间,YYYY / YYYY-MM / YYYY-MM-DD |
| citations | integer · range | 最小引用数(只支持 gte) |
还有 3 个,照样能用
| 字段 | 类型 · op | 含义 |
|---|---|---|
| source | keyword · eqarxiv · biorxiv · medrxiv | arxiv(默认)/ biorxiv / medrxiv |
| venues | keyword · eq anyNeurIPS · ICML · ICLR · AAAI · IJCAI · AISTATS …共 58 个,/facets 可列全 | 会议/期刊别名,如 NeurIPS、ICLR、CVPR |
| venue_year | integer · eq | 会议年份 |
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| query 必填 | string | 1–1000 字符。也可以是最多 5 条的数组(批量,hits 变 results[])。 |
| top_k | integer= 10 | 1–100。 |
| fields | brief · head= brief | head 多扣 1 credit,每条附 head 视图。 |
| filters | json | 过滤 DSL 对象(见快速开始);可用字段见上表。 |
| mode | hybrid= hybrid | 这个域只有一种模式——词面匹配,不是语义检索。 |
| offset | integer= 0 | 翻页。 |
示例
{ "domain": "papers", "query": "…", "hits": [ { "id": "2409.05591", "score": 0.83, "brief": { … } } ], "total": null, "coverage": …, "warnings": [],
"meta": { "request_id": "req_…", "credits": { "charged": 2, "balance": 1998, "pool": "allowance" }, "latency_ms": 41, "cached": false } } 用了未声明的过滤字段返回 400,不会静默忽略。过滤条件是 AND;可用
_or / _not。读
GET
/v1/papers/read/{arxiv_id}三档深浅,不传就是
detail。免费样例:2409.05591。三档
| 深浅 | credits | 返回 |
|---|---|---|
| brief | 1 | 标题、TLDR、关键词、日期、引用数、GitHub。~300 tok |
| detail (默认) | 2 | 元数据 + 章节地图(每节 name / tldr / token 数)+ 总 token 数 |
| full | 5 | 全文 markdown |
侧面
同一份文档的另一个侧面,与 level 二选一。
| 侧面 | credits | 返回 |
|---|---|---|
| trending | 1 | X/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 表示不完整。