用途:当任务需要借助 Hugging Face API 数据时,本技能用于构建可复用的命令行脚本与工具,便于链式调用、管道传递和中间处理。可直接访问 API,也可使用 hf 命令行工具,模型与数据集卡片可从仓库直接获取。
主要能力与用法:脚本必须支持 --help 参数说明输入与输出;非破坏性脚本在交付前需先测试;优先使用 Shell,复杂度或需求允许时用 Python 或 TSX。使用 HF_TOKEN 环境变量作为授权头,例如 curl -H "Authorization: Bearer ${HF_TOKEN}" https://huggingface.co/api/,以获得更高速率限制和受限内容的适当授权。设计前应先用小规模结果探查 API 返回结构,优先采用管道与链式组合的简单方案,完成后提供用法示例,有疑问时先确认用户偏好。
主要端点包括 /api/models、/api/datasets、/api/spaces、/api/collections、/api/daily_papers、/api/notifications、/api/settings、/api/whoami-v2、/api/trending。API 以 OpenAPI 标准记录,但不要直接读取过大的 openapi.json,应用 jq 查询所需部分。hf CLI 提供 auth、cache、download、endpoints、env、jobs、repo、repo-files、upload、upload-large-folder、version 等命令,已取代废弃的 huggingface_hub CLI。
参考示例:references 下含认证趋势脚本、按论文查找模型脚本、用 hf CLI 提取模型卡片 YAML 前言并输出 NDJSON 的脚本,以及 bash/python/typescript 基线示例、从 stdin 读取模型 ID 并逐行输出 JSON 的丰富脚本,并附管道组合用法。
限制:具体可用性、速率与权限受账户与令牌影响;资料未提供定价、平台支持等更多细节。