Límite gratuito de la API de Hugging Face Inference
Hugging Face Inference Providers es una sola API para modelos abiertos de muchos proveedores de inferencia. Antes incluía un pequeño crédito mensual gratuito para cada cuenta. Hoy la página oficial de precios no indica ningún crédito mensual para los usuarios gratuitos. Esta guía explica las reglas actuales, el error 402 y las opciones gratuitas.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
El límite gratuito actual
La página de precios de Hugging Face para Inference Providers tiene una tabla de créditos mensuales por tipo de cuenta. Los usuarios gratuitos no reciben crédito mensual. Solo pueden usar Inference Providers si compran créditos o pasan a PRO.
| Tipo de cuenta | Crédito mensual | Pago por uso |
|---|---|---|
| Usuario gratuito | Ninguno | Sí, se requiere compra de créditos |
| Usuario PRO | $2.00 | Sí |
| Organización Team o Enterprise | 2,00 USD por puesto, compartidos en la organización | Sí |
Los créditos de PRO y Team son créditos de cómputo generales. También puede gastarlos en Inference Endpoints, hardware de Spaces y Jobs. Hugging Face cobra la tarifa del proveedor sin cargo adicional.
Por qué aparece el error 402
HTTP 402 significa que se requiere pago. En Inference Providers, normalmente aparece cuando la cuenta no tiene crédito disponible. En una cuenta gratuita sin crédito comprado, la primera solicitud de pago puede devolver 402.
| Causa | Solución |
|---|---|
| Cuenta gratuita sin crédito comprado | Compre créditos en la página de facturación, o pase a PRO |
| Se agotó el crédito PRO de este mes | Espere al mes siguiente, o compre más créditos |
| La solicitud factura a una organización sin crédito | Elimine la cabecera X-HF-Bill-To, o pida al administrador de la organización que añada crédito |
Puede aparecer otro error cuando una organización desactiva un proveedor. Si pide ese proveedor por nombre, la solicitud falla. Use la selección automática de proveedor o elija otro proveedor.
Compruebe su uso en la página de ajustes de Inference Providers. Muestra el uso del último mes por modelo y por proveedor.
Cómo funciona la API
- Inicie sesión en Hugging Face y abra los ajustes de tokens.
- Cree un token de grano fino.
- Dé al token el permiso "Make calls to Inference Providers".
- Guarde el token en la variable de entorno
HF_TOKEN. - Compre créditos o pase a PRO. Sin crédito, una cuenta gratuita no puede completar solicitudes de pago.
Inference Providers tiene un endpoint compatible con OpenAI para las completaciones de chat en https://router.huggingface.co/v1. Se autentica con un token de grano fino de Hugging Face que tiene permiso para hacer llamadas a Inference Providers.
Cliente de OpenAI con un token de Hugging Face
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)- Añada
:fastestal ID del modelo para elegir el proveedor con mayor rendimiento. - Añada
:cheapestpara elegir el proveedor con el precio más bajo. - Añada el nombre de un proveedor, por ejemplo
:novita, para elegir un proveedor concreto. - El endpoint compatible con OpenAI es solo para chat. Use las bibliotecas cliente de Hugging Face para imágenes, embeddings y voz.
Para qué sirve Inference Providers
- Probar muchos modelos abiertos con un solo token, antes de elegir uno para producción.
- Modelos poco comunes en otros sitios, por ejemplo versiones nuevas de pesos abiertos y modelos para tareas especiales.
- Modelos de imagen, vídeo y audio mediante las bibliotecas cliente de Hugging Face.
- Equipos que ya pagan PRO o Team, porque el crédito incluido se aplica primero.
También puede descargar muchos modelos abiertos del Hub y ejecutarlos en su propio hardware. Herramientas como llama.cpp, vLLM y Ollama los sirven en local. La inferencia local no cuesta crédito de API, pero necesita una GPU o un equipo rápido. FreeLLMAPI puede añadir un servidor local compatible con OpenAI como proveedor personalizado, junto a los niveles gratuitos en la nube.
Inference Providers no es una API gratuita para el uso diario. Sin crédito mensual, una cuenta gratuita paga cada solicitud después de la compra. El crédito PRO de 2,00 USD también es pequeño para un agente o una aplicación de chat.
Opciones gratuitas para modelos abiertos
Muchos modelos abiertos de Hugging Face también tienen niveles gratuitos recurrentes en otros proveedores. La tabla muestra los modelos gratuitos más potentes del catálogo actual.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 solicitudes/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sí | No |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Sí | No |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 más | 1M | 40 solicitudes/min 40 RPM | Sí | Sí |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 solicitudes/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sí | Sí |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sí | No |
| Qwen3.8 Flash | ElectronHub, Inferbase | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Deepseek V4.1 Flash | APINex | 1M | 5 solicitudes/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | No | No |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | Sí |
| Agnes 3.0 Flash | Agnes AI | - | Promo $0/token | No | No |
Se muestran 12 de 354 modelos gratuitos que coinciden. Ver todos los modelos.
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
FreeLLMAPI tiene un adaptador para Hugging Face. El catálogo gratuito de hoy no tiene filas de Hugging Face, porque las cuentas gratuitas no tienen crédito recurrente. Para usar modelos abiertos gratuitos con una sola clave, añada claves de los proveedores de la tabla. El enrutador pasa al siguiente proveedor cuando uno devuelve un error de límite de velocidad.
Preguntas frecuentes
¿Es gratuita la API de Hugging Face Inference?
No para las cuentas gratuitas. La página de precios actual no indica ningún crédito mensual para los usuarios gratuitos. Deben comprar créditos o pasar a PRO, que incluye 2,00 USD de crédito de cómputo al mes.
¿Los usuarios gratuitos de Hugging Face siguen recibiendo 0,10 USD al mes?
La página oficial de precios no lo muestra hoy. No indica ningún crédito mensual para los usuarios gratuitos. Las páginas antiguas y algunas copias de la documentación todavía muestran la cifra de 0,10 USD.
¿Por qué Hugging Face devuelve el error 402 Payment Required?
Su cuenta o la organización facturada no tiene crédito disponible. Compre créditos, pase a PRO o espere al siguiente crédito mensual de PRO.
¿Es compatible con OpenAI el router de Hugging Face?
Sí, para las completaciones de chat. Defina la URL base como https://router.huggingface.co/v1 y use un token de Hugging Face como clave de API.
¿Cuál es una alternativa gratuita a Hugging Face Inference?
Use proveedores con niveles gratuitos recurrentes para modelos abiertos, como Groq, NVIDIA NIM, Cloudflare Workers AI u OVH AI Endpoints. FreeLLMAPI los reúne detrás de una sola clave.
Guías relacionadas
- URL base gratuitas compatibles con OpenAI
- API de LLM gratuita sin tarjeta de crédito
- Límites de uso de API LLM gratuitas
- API gratuita de OVH AI Endpoints
- API gratuita de embeddings
Fuentes
- Hugging Face docs: Inference Providers pricing and billing (revisado 20 November 2026)
- Hugging Face docs: Inference Providers (revisado 20 November 2026)
- UsagePricing: Hugging Face free inference credits removed (15 October 2026) (revisado 20 November 2026)
- FreeLLMAPI docs: Supported platforms (revisado 20 November 2026)