用途:Hugging Face Hub API 提供对公开模型、数据集与 Spaces(演示应用)的编程式搜索、发现和元数据读取,可用于基准测试中的模型选型、实验数据集发现、追踪社区采纳指标(下载量、点赞)以及引用具体模型修订版本(SHA)构建可复现的 ML 流水线。
主要能力:核心端点包括模型搜索 GET https://huggingface.co/api/models?search={query}&limit={n}&sort={field}&direction={-1|1},模型详情 GET https://huggingface.co/api/models/{owner}/{model_name}(返回 config.architectures、cardData、siblings、sha、lastModified);数据集搜索与详情 /api/datasets;Spaces 搜索 /api/spaces。搜索参数支持 search、limit、sort(downloads、likes、lastModified、trending)、direction、filter(pipeline 或 task 标签)、author、library、language 等,可组合使用缩小范围。
使用方式:读取端点无需认证。写入操作(上传模型、创建仓库)需设置访问令牌:export HF_TOKEN="hf_...",并通过请求头传递 curl -H "Authorization: Bearer $HF_TOKEN" https://huggingface.co/api/...;令牌可在 https://huggingface.co/settings/tokens 生成。除 curl 外,可使用 requests 库或 huggingface_hub 的 HfApi(如 list_models、model_info、list_datasets、list_spaces)。
适用场景:按 pipeline 标签(如 text-classification)加下载量排序寻找社区验证基线;按 task_categories、language、size_categories 筛选训练数据;用详情中的 sha 字段配合 revision 固定版本;从元数据中的 arxiv: 标签追踪原始论文;聚合下载与点赞分析模型家族采纳趋势。
限制:未认证速率限制较为宽松但未公开,使用 Bearer 令牌可获更高限额,无严格每分钟配额说明,遇到 HTTP 429 应指数退避;建议加 limit 参数并在本地缓存结果,避免一次拉取数千条。未提供认证之外的定价、平台或效果数据。