Inicio / Guías / Límite gratuito de la API de Hugging Face Inference

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.

Créditos mensuales de Inference Providers, de la página de precios de Hugging Face (revisado el 20 de noviembre de 2026)
Tipo de cuentaCrédito mensualPago por uso
Usuario gratuitoNingunoSí, se requiere compra de créditos
Usuario PRO$2.00Sí
Organización Team o Enterprise2,00 USD por puesto, compartidos en la organizaciónSí
Cifra anterior: muchas páginas todavía dicen que los usuarios gratuitos reciben 0,10 USD al mes. Esa cifra no aparece hoy en la página oficial de precios. Los rastreadores de terceros registraron el cambio en octubre de 2026. Las páginas antiguas de la documentación de Hugging Face todavía pueden mostrar el valor anterior.

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.

CausaSolución
Cuenta gratuita sin crédito compradoCompre créditos en la página de facturación, o pase a PRO
Se agotó el crédito PRO de este mesEspere al mes siguiente, o compre más créditos
La solicitud factura a una organización sin créditoElimine 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

  1. Inicie sesión en Hugging Face y abra los ajustes de tokens.
  2. Cree un token de grano fino.
  3. Dé al token el permiso "Make calls to Inference Providers".
  4. Guarde el token en la variable de entorno HF_TOKEN.
  5. 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 :fastest al ID del modelo para elegir el proveedor con mayor rendimiento.
  • Añada :cheapest para 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.

Modelos gratuitos más potentes del catálogo actual
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3APINex, UnoRouter1M5 solicitudes/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SíNo
Qwen3.8 MaxACLIDE-€20/month shared internal usage credits · no cardSíNo
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 más1M40 solicitudes/min
40 RPM
SíSí
Gemini 3.8 FlashAPINex, Google AI Studio1M5 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 NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub, Inferbase1M$0.25/week shared recurring creditSíSí
Deepseek V4.1 FlashAPINex1M5 solicitudes/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NoNo
Gemini 3.7 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSíSí
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíSí
Agnes 3.0 FlashAgnes AI-Promo $0/tokenNoNo

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.

Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

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

Fuentes

Todas las guías · Ver todos los modelos gratuitos