用途:在 Hugging Face Jobs 云端运行 Python 工作负载,适合没有本地 GPU/TPU 时执行实验、批量推理、大规模数据处理、循环任务,以及把结果持久化到 Hugging Face Hub。
主要能力:托管 CPU、GPU、TPU 算力;通过 secrets 加密注入凭据;支持作业超时与 flavor 选择;结果可推送模型或数据集到 Hub。
必要用法:需 Pro、Team 或 Enterprise 等付费计划,并用 hf_whoami() 确认登录。涉及 Hub 操作时必须提供 HF_TOKEN,推荐用 hf_jobs MCP 工具的 secrets={"HF_TOKEN": "$HF_TOKEN"},该占位符会自动替换;若用 HfApi().run_uv_job(),必须传真实 token(如 secrets={"HF_TOKEN": get_token()}),直接写字面量 "$HF_TOKEN" 会导致 401。脚本中从 os.environ 读取 HF_TOKEN。优先用 secrets 而非 env,因为 env 会出现在日志中。
限制:不替代环境特定验证、测试或专家审查;缺少输入、权限或成功标准时应先澄清;令牌权限需匹配操作,推送等写操作需写权限,访问私有仓库需相应授权。具体价格与配额暂未提供。