首页 / 指南 / Hugging Face Inference API 免费额度

Hugging Face Inference API 免费额度

Hugging Face Inference Providers 是一个 API,可访问来自多个推理提供方的开放模型。过去,每个账户每月都会获得一小笔免费额度。如今,官方定价页面不再为免费用户列出每月额度。本指南说明当前规则、402 错误以及免费选项。

代码、模型名称和目录中的实时标签以英文显示。

当前的免费额度

Hugging Face 的 Inference Providers 定价页面有一个表格,列出了各账户类型的每月额度。免费用户没有每月额度。只有购买额度或升级为 PRO 后,才能使用 Inference Providers。

Inference Providers 每月额度,取自 Hugging Face 定价页面(检查于 2026 年 11 月 20 日)
账户类型每月额度按量付费
免费用户无是,需要购买额度
PRO 用户$2.00是
Team 或 Enterprise 组织每个席位 $2.00,由组织共享是
旧的数据:许多页面仍写着免费用户每月可获得 $0.10。该数字如今已不在官方定价页面上。第三方追踪机构记录了这一变化,时间为 2026 年 10 月。较旧的 Hugging Face 文档页面仍可能显示旧的数值。

PRO 和 Team 额度是通用的计算额度。您也可以将其用于 Inference Endpoints、Spaces 硬件和 Jobs。Hugging Face 按提供方费率收费,不额外收费。

为何会出现 402 错误

HTTP 402 表示需要付款。在 Inference Providers 中,当您的账户没有剩余额度时,通常会出现此错误。在没有购买额度的免费账户上,第一次付费请求就可能返回 402。

原因解决方法
免费账户且未购买额度在账单页面购买额度,或升级为 PRO
本月的 PRO 额度已用完等待下个月,或购买更多额度
请求计费到一个没有额度的组织删除 X-HF-Bill-To 标头,或请组织管理员添加额度

当组织禁用某个提供方时,可能会出现另一种错误。如果您按名称请求该提供方,请求会失败。请使用自动提供方选择,或选择其他提供方。

您可以在 Inference Providers 设置页面查看用量。该页面按模型和提供方显示过去一个月的用量。

API 的工作方式

  1. 登录 Hugging Face,打开令牌设置。
  2. 创建一个细粒度令牌。
  3. 为该令牌授予权限 "Make calls to Inference Providers"。
  4. 将令牌保存到 HF_TOKEN 环境变量中。
  5. 购买额度或升级为 PRO。没有额度时,免费账户无法完成付费请求。

Inference Providers 在 https://router.huggingface.co/v1 提供兼容 OpenAI 的聊天补全端点。您需要使用具有调用 Inference Providers 权限的细粒度 Hugging Face 令牌进行身份验证。

使用 Hugging Face 令牌的 OpenAI 客户端

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://router.huggingface.co/v1",
    api_key=os.environ["HF_TOKEN"],
)

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4.1-Flash:fastest",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
  • 在模型 ID 后添加 :fastest,可选择吞吐量最高的提供方。
  • 添加 :cheapest,可选择价格最低的提供方。
  • 添加提供方名称,例如 :novita,可选择指定的一个提供方。
  • 兼容 OpenAI 的端点仅用于聊天。图像、嵌入和语音请使用 Hugging Face 客户端库。

Inference Providers 的适用场景

  • 测试多个开放模型:使用一个令牌,在为生产环境选定模型之前进行测试。
  • 其他地方较少见的模型,例如新发布的开放权重模型和特殊任务模型。
  • 图像、视频和音频模型:通过 Hugging Face 客户端库使用。
  • 已经为 PRO 或 Team 付费的团队,因为所含额度会优先使用。

您也可以从 Hub 下载许多开放模型,并在自己的硬件上运行。llama.cpp、vLLM 和 Ollama 等工具可以在本地提供服务。本地推理不消耗 API 额度,但您需要 GPU 或性能较强的计算机。FreeLLMAPI 可以将本地兼容 OpenAI 的服务器添加为自定义提供方,与免费的云端套餐并存。

Inference Providers 并不是可供日常使用的免费 API。没有每月额度时,免费账户在购买之后的每个请求都要付费。$2.00 的 PRO 额度对于代理或聊天应用来说也很少。

开放模型的免费选项

Hugging Face 上的许多开放模型,在其他提供方也有可持续的免费套餐。下表列出了当前目录中最强的免费模型。

当前目录中最强的免费模型
模型免费提供方上下文免费额度(最优惠)工具视觉
GLM 5.3APINex, UnoRouter1M5 请求/分钟
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
是否
Qwen3.8 MaxACLIDE-€20/month shared internal usage credits · no card是否
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM 另外 1 个1M40 请求/分钟
40 RPM
是是
Gemini 3.8 FlashAPINex, Google AI Studio1M5 请求/分钟
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
是是
Gemini Flash (latest alias)Google AI Studio-10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowance是否
Qwen3.8 FlashElectronHub, Inferbase1M$0.25/week shared recurring credit是是
Deepseek V4.1 FlashAPINex1M5 请求/分钟
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
否否
Gemini 3.7 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit是是
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 请求/分钟
50 请求/天
50 req/day account-wide (1,000 after a $10 purchase)
是是
Agnes 3.0 FlashAgnes AI-Promo $0/token否否

显示 12 个(共 354 个匹配的免费模型)。 查看所有模型.

数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。

FreeLLMAPI 提供 Hugging Face 适配器。由于免费账户没有可持续的额度,当前的免费目录中没有 Hugging Face 条目。若要通过一个密钥使用免费的开放模型,请添加表中提供方的密钥。当某个提供方返回速率限制错误时,路由器会切换到下一个提供方。

通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

Hugging Face Inference API 免费吗?

免费账户不免费。当前的定价页面不为免费用户列出每月额度。他们必须购买额度或升级为 PRO,PRO 每月包含 $2.00 的计算额度。

免费的 Hugging Face 用户仍然每月获得 $0.10 吗?

官方定价页面目前未显示此项。该页面不为免费用户列出每月额度。较旧的页面和部分文档镜像站仍显示 $0.10 这一数字。

为什么 Hugging Face 返回错误 402 Payment Required?

您的账户或被计费的组织已没有剩余额度。请购买额度、升级为 PRO,或等待下一个每月的 PRO 额度。

Hugging Face 路由器兼容 OpenAI 吗?

对于聊天补全,兼容。将基础 URL 设置为 https://router.huggingface.co/v1,并使用 Hugging Face 令牌作为 API 密钥。

Hugging Face Inference 的免费替代方案是什么?

为开放模型使用有可持续免费套餐的提供方,例如 Groq、NVIDIA NIM、Cloudflare Workers AI 或 OVH AI Endpoints。FreeLLMAPI 通过一个密钥将它们整合在一起。

相关指南

来源

全部指南 · 浏览所有免费模型