旧版 API

旧版 API（DeepXiv 路径）

原 DeepXiv 路径在本网关原样提供——参数、响应都不变——用 fa_live_ key 鉴权，按 credits 计费，与对应的 /v1 端点同价（用量里 op=legacy）。deepxiv CLI 和 deepxiv-sdk 包用的就是它们。老的 DeepXiv token 继续在 https://data.rag.ac.cn 上按老配额可用，这里不认。

问 arXivregistered key+ /stream

POST/arxiv/agent/search

问题进去；服务在全文语料上做混合检索，读需要的章节，返回带真实 ID 的回答——[arXiv:2512.15176]。加 /stream 走 NDJSON 事件流。

CLIdeepxiv ask "…"

参数

参数	类型		说明
query	string	必填	1–2000 字符。问得具体；要数字就直接问数字。
effort	default \| high \| xhigh	= default	检索轮数上限：1–2 / 3 / 4–5。
verbose	bool	= false	返回工具调用轨迹（流式时多 `tool_call` / `tool_result` / `thinking` 事件）。
top_k	integer	= 10	预取候选数，1–30。
stream_answer	bool	= true	仅流式端点。`false` 时只发一个 `answer` 事件而非增量。
max_rounds	integer	可选	0–8。覆盖 effort 预设。`0` 直接用预取结果作答——首 token ≈1.3s。
force_answer_after	number	可选	0.5–30 秒。强制切入作答阶段。
max_answer_tokens	integer	= 4096	256–16384。触顶时置 `answer_truncated`。
language	string	可选	回答语言。默认跟随 query 的语言。

示例

{
  "answer": "DEER reports a 5.54× speedup on HumanEval ... [arXiv:2512.15176]",
  "sources": [ { "arxiv_id": "2512.15176", "title": "...", "url": "https://arxiv.org/abs/2512.15176" } ],
  "stats": { "rounds": 1, "elapsed_s": 6.2, "answer_truncated": false },
  "trace": [ ... ],                       // only when verbose=true
  "quota": { "tier": "free", "used": 3, "limit": 30 }
}

仅限注册 key。SDK 自动注册的 token 会返回 403。每个注册账号每天 30 次 agentic 调用，免费，arXiv / web / talent 共用。

引用是真的。从不编造 ID，找不到就说"没有相关论文"。sources 是检索集，不是引用列表——按 answer 里出现的 ID 过滤。answer_truncated 表示不完整——下游要明说。

brief

GET/arxiv/?type=brief&arxiv_id={arxiv_id}

标题、TLDR、关键词、发表日期、引用数、GitHub 地址。约 300 token——足够判断值不值得读。

CLIdeepxiv paper 2409.05591 --brief

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

响应

arxiv_idarXiv ID
title标题
tldr生成的一段摘要
keywords关键词列表
publish_at发表日期
citations引用数
github_url代码仓库（如有）
src_urlPDF 链接

head

GET/arxiv/?type=head&arxiv_id={arxiv_id}

结构化元数据加章节地图：每节的名称、TLDR 和 token 数，agent 付费之前就知道答案在哪一节。含总 token_count。

CLIdeepxiv paper 2409.05591 --head

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

响应

title / abstract / authors作者含姓名、机构，可选 misc（邮箱、orcid）
sections[{ name, idx, tldr, token_count }]
token_count全文 token 数
venue / journal_name / citations / categories / publish_at / keywords / github_url如有

section

GET/arxiv/?type=section&arxiv_id={arxiv_id}§ion={section}

一整节，干净的 markdown。节名来自 head。

CLIdeepxiv paper 2409.05591 --section "2. Method"

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
section	string	必填	节名，与 `head` 列出的一致，如 `1. Introduction`。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

preview

GET/arxiv/?type=preview&arxiv_id={arxiv_id}

论文前 N 个字符。返回 is_truncated 和 total_characters。

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
characters	integer	= 10000	100–100000。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

raw

GET/arxiv/?type=raw&arxiv_id={arxiv_id}

全文 markdown。最后再用。

CLIdeepxiv paper 2409.05591 --raw

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

json

GET/arxiv/?type=json&arxiv_id={arxiv_id}

完整结构化文档：元数据加每一节，JSON。

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

markdown（HTML 视图）

GET/arxiv/?type=markdown&arxiv_id={arxiv_id}

给浏览器看的渲染页。打开 2409.05591。

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

检索

GET/arxiv/?type=retrieve&query={query}

在 arXiv、bioRxiv、medRxiv 上做混合检索（metadata / section / RoC 三路索引的稠密 + 稀疏召回，可选精排）。返回排序列表而非答案——要带引用的回答请用问 arXiv。transformer、attention mechanism、large language model 三个 query 免费。

CLIdeepxiv search "agentic memory" --venue NeurIPS --venue-year 2025

参数

参数	类型		说明
query	string	必填	最多 500 字符。
source	arxiv \| biorxiv \| medrxiv	= arxiv	结果里的 ID 字段随来源：`arxiv_id` / `biorxiv_id` / `medrxiv_id`。
top_k	integer	= 10	1–100。
offset	integer	= 0	翻页偏移，0–10000。
authors	string[]	可选	既过滤也影响排序。每个值重复一次参数。
orgs	string[]	可选	机构过滤，也影响排序。
categories	string[]	可选	如 `cs.AI`、`cs.CL`。纯过滤。
venue	string[]	可选	NeurIPS、ICLR、CVPR… 别名自动解析（NeurIPS ↔ NIPS）。`venues` 等价。
venue_year	integer	可选	1900–2100，从 venue 字符串解析。
min_citation	integer	可选	最低引用数。纯过滤。
date_search_type	exact \| after \| before \| between	可选	与 `date_str` 配合。
date_str	string[]	可选	`YYYY` / `YYYY-MM` / `YYYY-MM-DD`；`between` 传起止两个。
search_funcs	string[]	可选	索引类型，默认 `metadata, section, roc`。
use_fine_rerank	bool	= true	召回后精排。
return_contents	bool	= false	返回命中的章节内容。
return_roc	bool	= false	返回 RoC 列表。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

示例

{
  "status": "success", "total_count": 3,
  "result": [ { "arxiv_id": "2506.18871", "score": 0.9475, "title": "...", "tldr": "...", "abstract": "...",
                "authors": [{ "name": "...", "orgs": ["..."] }], "url": "https://arxiv.org/abs/2506.18871",
                "date": "2025-06-23T17:38:54Z", "citation_count": 217, "categories": ["cs.CV"] } ]
}

过滤条件是 AND。窄日期窗叠高引用门槛返回 0 条是正常的——放宽一个。旧参数 size、search_mode、bm25_weight、vector_weight、date_from、date_to 已下线。

热度信号

GET/arxiv/trending_signal?arxiv_id={arxiv_id}&token={token}

单篇论文的社交热度：推文、点赞、浏览、回复，首次与最近出现时间。404 表示还没有讨论——正常。

CLIdeepxiv trending · deepxiv paper 2409.05591 --popularity

参数

参数	类型		说明
arxiv_id	string	必填	arXiv 论文 ID。`2409.05591` 和 `2504.21776` 免费。
token	string	必填	本端点必填。

示例

{ "arxiv_id": "2409.05591", "total_tweets": 150, "total_likes": 3200, "total_views": 25000, "total_replies": 45,
  "first_seen_date": "2024-09-05T10:30:00", "last_seen_date": "2024-09-10T14:20:00" }

PMC · head

GET/pmc/?type=head&pmc_id={pmc_id}

PubMed Central 元数据：标题、DOI、摘要、作者、分类、日期。PMC544940 和 PMC514704 免费。

参数

参数	类型		说明
pmc_id	string	必填	PMC ID。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

PMC · json

GET/pmc/?type=json&pmc_id={pmc_id}

完整结构化文章。

参数

参数	类型		说明
pmc_id	string	必填	PMC ID。
token	string	可选	API token，或用 `Authorization: Bearer`。免费论文不需要。

问网页registered key+ /stream

POST/web/agent/search

请求体同"问 arXiv"，用 Google 结果加缓存页面正文作答。回答带真实 URL 的 markdown 链接；每个来源带 read: true|false。共用 agentic 配额。

CLIdeepxiv ask --web "…"

参数

参数	类型		说明
query	string	必填	1–2000 字符。问得具体；要数字就直接问数字。
effort	default \| high \| xhigh	= default	检索轮数上限：1–2 / 3 / 4–5。
verbose	bool	= false	返回工具调用轨迹（流式时多 `tool_call` / `tool_result` / `thinking` 事件）。
search_type	search \| scholar \| news \| images	= search	Google 垂直类型。
gl	string	= us	Google 国家码。中文 query 自动切到 `cn`。
hl	string	= en	搜索语言。中文 query 自动切到 `zh-cn`。
stream_answer	bool	= true	仅流式端点。`false` 时只发一个 `answer` 事件而非增量。
max_rounds	integer	可选	0–8。覆盖 effort 预设。`0` 直接用预取结果作答——首 token ≈1.3s。
force_answer_after	number	可选	0.5–30 秒。强制切入作答阶段。
max_answer_tokens	integer	= 4096	256–16384。触顶时置 `answer_truncated`。
language	string	可选	回答语言。默认跟随 query 的语言。

网页证据有两种强度。只读缓存的页面正文——从不实时抓取——未缓存的页面只贡献摘要。把 read 暴露出去，让 agent 对弱证据加限定。中文站点和新闻页缓存较少。

web 比 arXiv 慢：上游缓存未命中要 1.7–4.3s。首 token 目标是 10s 而非 5s。

原始网页搜索

POST/websearch

上游搜索 API 的 organic 结果，不读、不作答。每次扣 50 次通用请求。除非你就要结果列表，否则优先用问网页。

参数

参数	类型		说明
query	string	必填	搜索词。
search_type	scholar \| web	= scholar	`scholar` 或 `web`。
page	integer	= 1	结果页码。
use_cache	bool	= true	有缓存时用缓存。

每次 50 次通用请求