محدودیت رایگان Hugging Face Inference API
Hugging Face Inference Providers یک API برای مدلهای باز از ارائهدهندگان استنتاج زیاد است. قبلاً برای هر حساب یک اعتبار ماهانه رایگان کوچک داشت. امروز صفحه قیمت رسمی هیچ اعتبار ماهانهای برای کاربران رایگان فهرست نمیکند. این راهنما قوانین فعلی، خطای 402 و گزینههای رایگان را توضیح میدهد.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
محدودیت رایگان فعلی
صفحه قیمت Hugging Face برای Inference Providers جدولی از اعتبار ماهانه بر اساس نوع حساب دارد. کاربران رایگان هیچ اعتبار ماهانهای نمیگیرند. آنها فقط وقتی میتوانند Inference Providers را استفاده کنند که اعتبار بخرند یا به PRO ارتقا دهند.
| نوع حساب | اعتبار ماهانه | پرداخت بهازای استفاده |
|---|---|---|
| کاربر رایگان | ندارد | بله، خرید اعتبار لازم است |
| کاربر 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 وارد شوید و تنظیمات توکن را باز کنید.
- یک توکن fine-grained بسازید.
- به توکن اجازه «Make calls to Inference Providers» را بدهید.
- توکن را در متغیر محیطی
HF_TOKENذخیره کنید. - اعتبار بخرید یا به PRO ارتقا دهید. بدون اعتبار، یک حساب رایگان نمیتواند درخواستهای پولی را کامل کند.
Inference Providers یک نقطه پایانی سازگار با OpenAI برای تکمیل گفتگو روی https://router.huggingface.co/v1 دارد. شما با یک توکن fine-grained از Hugging Face که اجازه فراخوانی Inference Providers را دارد، احراز هویت میکنید.
کلاینت OpenAI با توکن 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)- برای انتخاب ارائهدهنده با بیشترین توان عملیاتی،
:fastestرا به شناسه مدل اضافه کنید. - برای انتخاب ارائهدهنده با کمترین قیمت،
:cheapestرا اضافه کنید. - برای انتخاب یک ارائهدهنده، نام آن را اضافه کنید، برای مثال
:novita. - نقطه پایانی سازگار با OpenAI فقط برای گفتگو است. برای تصویر، embedding و گفتار از کتابخانههای کلاینت Hugging Face استفاده کنید.
Inference Providers برای چه کارهایی خوب است
- آزمایش مدلهای باز زیاد با یک توکن، پیش از انتخاب یکی برای تولید.
- مدلهایی که در جای دیگر کمیاباند، برای مثال انتشارهای جدید مدلهای open-weight و مدلهای وظیفهویژه.
- مدلهای تصویر، ویدیو و صوت از طریق کتابخانههای کلاینت Hugging Face.
- تیمهایی که از قبل PRO یا Team میپردازند، چون اعتبار شامل اول اعمال میشود.
میتوانید بسیاری از مدلهای باز را هم از Hub دانلود کنید و روی سختافزار خودتان اجرا کنید. ابزارهایی مانند llama.cpp، vLLM و Ollama آنها را به صورت محلی ارائه میدهند. استنتاج محلی اعتبار API نمیخواهد، اما به GPU یا یک رایانه سریع نیاز دارید. FreeLLMAPI میتواند یک سرور محلی سازگار با OpenAI را به عنوان ارائهدهنده سفارشی، کنار سطوح رایگان ابری اضافه کند.
Inference Providers API رایگان برای استفاده روزانه نیست. بدون اعتبار ماهانه، یک حساب رایگان بعد از خرید، برای هر درخواست پول میدهد. اعتبار PRO با 2.00 دلار هم برای یک عامل یا یک برنامه گفتگو کوچک است.
گزینههای رایگان برای مدلهای باز
بسیاری از مدلهای باز در 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 ارتقا دهند، که شامل 2.00 دلار اعتبار محاسباتی در ماه است.
آیا کاربران رایگان Hugging Face هنوز ماهانه 0.10 دلار میگیرند؟
صفحه قیمت رسمی امروز این را نشان نمیدهد. هیچ اعتبار ماهانهای برای کاربران رایگان فهرست نمیکند. صفحات قدیمی و برخی آینههای مستندات هنوز عدد 0.10 دلار را نشان میدهند.
چرا Hugging Face خطای 402 Payment Required برمیگرداند؟
حساب شما یا سازمان صورتحسابشده اعتبار باقیمانده ندارد. اعتبار بخرید، به PRO ارتقا دهید، یا تا اعتبار ماهانه PRO بعدی صبر کنید.
آیا روتر Hugging Face سازگار با OpenAI است؟
بله، برای تکمیل گفتگو. آدرس پایه را روی https://router.huggingface.co/v1 تنظیم کنید و یک توکن Hugging Face را به عنوان کلید API استفاده کنید.
جایگزین رایگان Hugging Face Inference چیست؟
از ارائهدهندگانی با سطوح رایگان تکرارشونده برای مدلهای باز استفاده کنید، مانند Groq، NVIDIA NIM، Cloudflare Workers AI یا OVH AI Endpoints. FreeLLMAPI آنها را پشت یک کلید جمع میکند.
راهنماهای مرتبط
- آدرسهای پایه API سازگار با OpenAI رایگان
- API رایگان LLM بدون کارت اعتباری
- محدودیت نرخ API رایگان LLM
- API رایگان OVH AI Endpoints
- API رایگان embedding
منابع
- 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)