Hugging Face 论文页面

Hugging Face 论文页面（hf.co/papers）是一个构建在 arXiv（arxiv.org）之上的平台，专为人工智能（AI）与计算机科学领域的研究论文而设计。Hugging Face 用户可通过 hf.co/papers/submit 提交自己的论文，该论文将出现在每日论文动态流（hf.co/papers）中。每天，用户可对论文进行点赞和评论。每篇论文页面允许作者执行以下操作：

• 认领其论文（点击 authors 字段中的作者姓名）。此举将使该论文页面显示在其 Hugging Face 个人资料页中。
• 通过在模型卡片（model card）、数据集卡片（dataset card）或 Space 的 README 中嵌入 HF 论文 URL 或 arXiv URL，关联对应的模型检查点（model checkpoints）、数据集（datasets）及 Spaces。
• 关联 GitHub 仓库和/或项目主页 URL。
• 关联 HF 组织（HF organization）。此举也将使该论文页面显示在对应 Hugging Face 组织页面上。

每当有人在模型卡片、数据集卡片或 Space 仓库的 README 中提及某篇 HF 论文 URL 或 arXiv 摘要/PDF URL 时，该论文将被自动索引。需注意：并非所有在 Hugging Face 上被索引的论文都会被提交至“每日论文”动态流；后者更侧重于对研究论文的推广。论文仅可在其 arXiv 发表日期起 14 天内提交至“每日论文”动态流。

Hugging Face 团队构建了一个易于使用的 API，用于与论文页面交互。论文内容可获取为 Markdown 格式，也可返回结构化元数据，例如作者姓名、关联的模型/数据集/Spaces、关联的 GitHub 仓库及项目主页等。

适用场景

• 用户分享一个 Hugging Face 论文页面 URL（例如：https://huggingface.co/papers/2602.08025）
• 用户分享一个 Hugging Face Markdown 格式论文页面 URL（例如：https://huggingface.co/papers/2602.08025.md）
• 用户分享一个 arXiv URL（例如：https://arxiv.org/abs/2602.08025 或 https://arxiv.org/pdf/2602.08025）
• 用户提及一个 arXiv ID（例如：2602.08025）
• 用户要求你总结、解释或分析一篇 AI 研究论文

解析论文 ID

建议从用户提供的任意输入中提取论文 ID（即 arXiv ID）：

提取出的论文 ID 可用于下文所述任一 Hub API 接口。

以 Markdown 格式获取论文页面

可通过如下方式以 Markdown 格式获取论文内容：

curl -s "https://huggingface.co/papers/{PAPER_ID}.md"

该请求将返回 Hugging Face 论文页面的 Markdown 内容，其底层依赖于 arXiv 提供的 HTML 版本（https://arxiv.org/html/{PAPER_ID}）。

存在两种例外情况：

• 并非所有 arXiv 论文都提供 HTML 版本。若该论文无 HTML 版本，则内容将回退至 Hugging Face 论文页面自身的 HTML 渲染结果。
• 若返回 404 错误，则表示该论文尚未在 hf.co/papers 上建立索引。详见“错误处理”章节。

此外，您也可向常规论文页面 URL 发起带特定请求头的请求来获取 Markdown 内容，示例如下：

curl -s -H "Accept: text/markdown" "https://huggingface.co/papers/{PAPER_ID}"

论文页面 API 接口

所有接口均基于基础 URL：https://huggingface.co。

获取结构化元数据

使用 Hugging Face REST API 以 JSON 格式获取论文元数据：

curl -s "https://huggingface.co/api/papers/{PAPER_ID}"

该接口返回结构化元数据，可能包括：

• 作者信息（姓名及 Hugging Face 用户名，若作者已认领该论文）
• 媒体资源 URL（在向“每日论文”提交论文时上传）
• 摘要（abstract）及 AI 生成的摘要
• 项目主页与 GitHub 仓库地址
• 组织信息与互动元数据（如点赞数）

如需查找与该论文关联的模型，请使用：

curl https://huggingface.co/api/models?filter=arxiv:{PAPER_ID}

如需查找与该论文关联的数据集，请使用：

curl https://huggingface.co/api/datasets?filter=arxiv:{PAPER_ID}

如需查找与该论文关联的 Spaces，请使用：

curl https://huggingface.co/api/spaces?filter=arxiv:{PAPER_ID}

认领论文作者身份

为某位 Hugging Face 用户认领某篇论文的作者身份：

curl "https://huggingface.co/api/settings/papers/claim" 
  --request POST 
  --header "Content-Type: application/json" 
  --header "Authorization: Bearer $HF_TOKEN" 
  --data '{
    "paperId": "{PAPER_ID}",
    "claimAuthorId": "{AUTHOR_ENTRY_ID}",
    "targetUserId": "{USER_ID}"
  }'

• 接口路径：POST /api/settings/papers/claim
• 请求体（Body）：
  • paperId（字符串，必填）：待认领的 arXiv 论文标识符
  • claimAuthorId（字符串）：论文中待认领的作者条目 ID，为 24 位十六进制字符串
  • targetUserId（字符串）：应接收该认领的 HF 用户 ID，为 24 位十六进制字符串
• 响应：论文作者身份认领结果，包含已认领的论文 ID

获取每日论文列表

获取“每日论文”动态流：

curl -s -H "Authorization: Bearer $HF_TOKEN" 
  "https://huggingface.co/api/daily_papers?p=0&limit=20&date=2017-07-21&sort=publishedAt"

• 接口路径：GET /api/daily_papers
• 查询参数：
  • p（整数）：页码
  • limit（整数）：返回结果数量，取值范围为 1–100
  • date（字符串）：RFC 3339 全日期格式，例如 2017-07-21
  • week（字符串）：ISO 周格式，例如 2024-W03
  • month（字符串）：月份格式，例如 2024-01
  • submitter（字符串）：按提交者过滤
  • sort（枚举值）：publishedAt 或 trending
• 响应：每日论文列表

列出论文

按发表日期排序列出 arXiv 论文：

curl -s -H "Authorization: Bearer $HF_TOKEN" 
  "https://huggingface.co/api/papers?cursor={CURSOR}&limit=20"

• 接口路径：GET /api/papers
• 查询参数：
  • cursor（字符串）：分页游标
  • limit（整数）：返回结果数量，取值范围为 1–100
• 响应：论文列表

搜索论文

对论文执行混合语义与全文搜索：

curl -s -H "Authorization: Bearer $HF_TOKEN" 
  "https://huggingface.co/api/papers/search?q=vision+language&limit=20"

该搜索覆盖论文标题、作者及正文内容。

• 接口路径：GET /api/papers/search
• 查询参数：
  • q（字符串）：搜索关键词，最大长度为 250
  • limit（整数）：返回结果数量，取值范围为 1–120
• 响应：匹配的论文列表

索引一篇论文

根据 arXiv ID 插入一篇论文。若该论文已被索引，则仅其作者可重新索引：

curl "https://huggingface.co/api/papers/index" 
  --request POST 
  --header "Content-Type: application/json" 
  --header "Authorization: Bearer $HF_TOKEN" 
  --data '{
    "arxivId": "{ARXIV_ID}"
  }'

• 接口路径：POST /api/papers/index
• 请求体（Body）：
  • arxivId（字符串，必填）：待索引的 arXiv ID，例如 2301.00001
• 匹配模式：^d{4}.d{4,5}$
• 响应：成功时返回空 JSON 对象

更新论文链接

更新某篇论文的项目主页、GitHub 仓库或提交组织信息。请求方必须是该论文作者、“每日论文”提交者或论文管理员：

curl "https://huggingface.co/api/papers/{PAPER_OBJECT_ID}/links" 
  --request POST 
  --header "Content-Type: application/json" 
  --header "Authorization: Bearer $HF_TOKEN" 
  --data '{
    "projectPage": "https://example.com",
    "githubRepo": "https://github.com/org/repo",
    "organizationId": "{ORGANIZATION_ID}"
  }'

• 接口路径：POST /api/papers/{paperId}/links
• 路径参数：
  • paperId（字符串，必填）：Hugging Face 论文对象 ID
• 请求体（Body）：
  • githubRepo（字符串，可为空）：GitHub 仓库 URL
  • organizationId（字符串，可为空）：组织 ID（24 位十六进制字符串）
  • projectPage（字符串，可为空）：项目主页 URL
• 响应：成功时返回空 JSON 对象

错误处理

• 访问 https://huggingface.co/papers/{PAPER_ID} 或 .md 接口返回 404：该论文尚未在 Hugging Face 论文页面建立索引。
• 访问 /api/papers/{PAPER_ID} 返回 404：该论文可能尚未在 Hugging Face 论文页面建立索引。
• 未找到论文 ID：请核对所提取的 arXiv ID（含版本后缀，如 v1）是否正确。

备用方案

若 Hugging Face 论文页面内容不足以回答用户问题：

• 查看标准论文页面：https://huggingface.co/papers/{PAPER_ID}
• 回退至原始 arXiv 页面或 PDF 获取权威来源：
  • https://arxiv.org/abs/{PAPER_ID}
  • https://arxiv.org/pdf/{PAPER_ID}

注意事项

• 公开论文页面无需身份验证。
• 涉及写操作的接口（如认领作者身份、索引论文、更新论文链接）需携带 Authorization: Bearer $HF_TOKEN 请求头。
• 如需稳定、机器可读的输出，优先使用 .md 接口。
• 如需结构化 JSON 字段而非页面 Markdown 内容，优先使用 /api/papers/{PAPER_ID} 接口。