Hugging Face Inference API 免费额度
Hugging Face Inference Providers 是一个 API,可访问来自多个推理提供方的开放模型。过去,每个账户每月都会获得一小笔免费额度。如今,官方定价页面不再为免费用户列出每月额度。本指南说明当前规则、402 错误以及免费选项。
代码、模型名称和目录中的实时标签以英文显示。
当前的免费额度
Hugging Face 的 Inference Providers 定价页面有一个表格,列出了各账户类型的每月额度。免费用户没有每月额度。只有购买额度或升级为 PRO 后,才能使用 Inference Providers。
| 账户类型 | 每月额度 | 按量付费 |
|---|---|---|
| 免费用户 | 无 | 是,需要购买额度 |
| PRO 用户 | $2.00 | 是 |
| Team 或 Enterprise 组织 | 每个席位 $2.00,由组织共享 | 是 |
PRO 和 Team 额度是通用的计算额度。您也可以将其用于 Inference Endpoints、Spaces 硬件和 Jobs。Hugging Face 按提供方费率收费,不额外收费。
为何会出现 402 错误
HTTP 402 表示需要付款。在 Inference Providers 中,当您的账户没有剩余额度时,通常会出现此错误。在没有购买额度的免费账户上,第一次付费请求就可能返回 402。
| 原因 | 解决方法 |
|---|---|
| 免费账户且未购买额度 | 在账单页面购买额度,或升级为 PRO |
| 本月的 PRO 额度已用完 | 等待下个月,或购买更多额度 |
| 请求计费到一个没有额度的组织 | 删除 X-HF-Bill-To 标头,或请组织管理员添加额度 |
当组织禁用某个提供方时,可能会出现另一种错误。如果您按名称请求该提供方,请求会失败。请使用自动提供方选择,或选择其他提供方。
您可以在 Inference Providers 设置页面查看用量。该页面按模型和提供方显示过去一个月的用量。
API 的工作方式
- 登录 Hugging Face,打开令牌设置。
- 创建一个细粒度令牌。
- 为该令牌授予权限 "Make calls to Inference Providers"。
- 将令牌保存到
HF_TOKEN环境变量中。 - 购买额度或升级为 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.3 | APINex, UnoRouter | 1M | 5 请求/分钟 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | 是 | 否 |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | 是 | 否 |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM 另外 1 个 | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 请求/分钟 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 Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Deepseek V4.1 Flash | APINex | 1M | 5 请求/分钟 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 否 | 否 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | 否 | 否 |
显示 12 个(共 354 个匹配的免费模型)。 查看所有模型.
数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。
FreeLLMAPI 提供 Hugging Face 适配器。由于免费账户没有可持续的额度,当前的免费目录中没有 Hugging Face 条目。若要通过一个密钥使用免费的开放模型,请添加表中提供方的密钥。当某个提供方返回速率限制错误时,路由器会切换到下一个提供方。
常见问题
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 通过一个密钥将它们整合在一起。
相关指南
来源
- Hugging Face docs: Inference Providers pricing and billing (检查于 20 November 2026)
- Hugging Face docs: Inference Providers (检查于 20 November 2026)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (检查于 20 November 2026)
- FreeLLMAPI docs: Supported platforms (检查于 20 November 2026)