خانه / راهنماها / محدودیت رایگان Hugging Face Inference API

محدودیت رایگان Hugging Face Inference API

Hugging Face Inference Providers یک API برای مدل‌های باز از ارائه‌دهندگان استنتاج زیاد است. قبلاً برای هر حساب یک اعتبار ماهانه رایگان کوچک داشت. امروز صفحه قیمت رسمی هیچ اعتبار ماهانه‌ای برای کاربران رایگان فهرست نمی‌کند. این راهنما قوانین فعلی، خطای 402 و گزینه‌های رایگان را توضیح می‌دهد.

کد، نام مدل‌ها و برچسب‌های زندهٔ کاتالوگ به زبان انگلیسی نمایش داده می‌شوند.

محدودیت رایگان فعلی

صفحه قیمت Hugging Face برای Inference Providers جدولی از اعتبار ماهانه بر اساس نوع حساب دارد. کاربران رایگان هیچ اعتبار ماهانه‌ای نمی‌گیرند. آن‌ها فقط وقتی می‌توانند Inference Providers را استفاده کنند که اعتبار بخرند یا به PRO ارتقا دهند.

اعتبارهای ماهانه Inference Providers، از صفحه قیمت Hugging Face (بررسی‌شده در 20 نوامبر 2026)
نوع حساباعتبار ماهانهپرداخت به‌ازای استفاده
کاربر رایگاننداردبله، خرید اعتبار لازم است
کاربر PRO$2.00بله
سازمان Team یا Enterprise2.00 دلار برای هر صندلی، مشترک در سازمانبله
عدد قدیمی: بسیاری از صفحات هنوز می‌گویند کاربران رایگان ماهانه 0.10 دلار می‌گیرند. این عدد امروز در صفحه قیمت رسمی نیست. ردیاب‌های شخص ثالث این تغییر را در اکتبر 2026 ثبت کردند. صفحات قدیمی مستندات 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. یک توکن fine-grained بسازید.
  3. به توکن اجازه «Make calls to Inference Providers» را بدهید.
  4. توکن را در متغیر محیطی HF_TOKEN ذخیره کنید.
  5. اعتبار بخرید یا به 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.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 ارتقا دهند، که شامل 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 آن‌ها را پشت یک کلید جمع می‌کند.

راهنماهای مرتبط

منابع

همه راهنماها · مرور همه مدل‌های رایگان