خانه / راهنماها / استفاده از Cursor با یک API رایگان LLM

استفاده از Cursor با یک API رایگان LLM

Cursor می‌تواند درخواست‌های گفتگو را به کلید API OpenAI شما بفرستد. این راهنما نشان می‌دهد که چطور آن کلید را از طریق FreeLLMAPI به مدل‌های رایگان وصل کنید. همچنین محدودیت‌ها را توضیح می‌دهد. Cursor هر درخواست را از طریق سرورهای خودش مسیریابی می‌کند و تکمیل Tab همیشه از مدل‌های Cursor استفاده می‌کند.

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

آنچه کار می‌کند و آنچه کار نمی‌کند

پیش از شروع این بخش را بخوانید. پشتیبانی Cursor از کلید شخصی محدودتر از بیشتر ویرایشگرهای دیگر است.

قابلیت Cursorبا کلید شخصی شمامنبع
گفتگو با یک مدل استاندارد سبک OpenAIبله. Cursor کلیدهای شخصی OpenAI را برای مدل‌های گفتگوی استاندارد و بدون استدلال مستند کرده است.صفحه راهنمای کلیدهای API در Cursor
تکمیل Tabخیر. Cursor می‌گوید که Tab همچنان از مدل‌های داخلی Cursor استفاده می‌کند.صفحه راهنمای کلیدهای API در Cursor
حالت Agent و Composerتأیید نشده است. مستندات Cursor فقط مدل‌های گفتگو را نام می‌برند. پیش از اتکا به آن، روی طرح خود آزمایش کنید.مستند نشده
درخواست‌ها از localhostخیر. Cursor برای ساخت prompt همه درخواست‌ها را از سرورهای خود می‌فرستد، پس localhost روی رایانه شما در مسیر نیست.صفحه راهنمای کلیدهای API در Cursor

طرح‌ها هم مهم هستند. صفحه قیمت Cursor مدل‌های شخص ثالث و کلیدهای شخصی API را در طرح‌های Premium، Super و Ultra فهرست می‌کند. می‌گوید که طرح Plus کلید شخصی API ندارد. برای طرح Free، صفحه مدل‌های شخص ثالث را غیرقابل استفاده نشان می‌دهد. پیش از ادامه، صفحه قیمت را برای طرح خود بررسی کنید.

توجه: اگر یک عامل ویرایشگر رایگان می‌خواهید که قوانین طرح ندارد، از Cline، Roo Code یا Kilo Code در VS Code استفاده کنید. این‌ها مستقیماً به localhost وصل می‌شوند. Cline، Roo Code و Kilo Code با یک API رایگان را بخوانید.

مرحله 1: نصب FreeLLMAPI و قابل دسترس کردن آن

FreeLLMAPI متن‌باز است و روی رایانه شما در Docker اجرا می‌شود. آن را نصب کنید، سپس حداقل دو کلید رایگان ارائه‌دهنده را در صفحه Keys اضافه کنید.

نصب روی macOS یا Linux

curl -fsSL https://freellmapi.co/install.sh | bash

کلید یکپارچه را از صفحه Keys کپی کنید. سپس به دروازه یک نشانی عمومی HTTPS بدهید، زیرا سرورهای Cursor به localhost شما دسترسی ندارند. از یک تونل HTTPS مطمئن یا سروری که کنترل آن را دارید استفاده کنید. راهنمای FreeLLMAPI برای Cursor این مراحل را چاپ می‌کند:

چاپ راهنمای Cursor

npx freellmapi setup-cursor

این دستور هیچ فایلی نمی‌نویسد. Cursor برای این تنظیم فایل پیکربندی ندارد، پس مقادیر را در تنظیمات Cursor وارد می‌کنید.

امنیت: یک نشانی عمومی به هر کسی که کلید یکپارچه شما را داشته باشد اجازه می‌دهد از سهمیه‌های رایگان شما استفاده کند. هرگز کلید را به اشتراک نگذارید. اگر تونل شما نمی‌تواند هدر Authorization بفرستد، یک توکن نشانی جداگانه و قابل لغو در Keys, Agents بسازید. وقتی کار را متوقف می‌کنید، آن را لغو کنید.

مرحله 2: تنظیم کلید و آدرس پایه در Cursor

  1. Cursor Settings را باز کنید.
  2. Models را باز کنید.
  3. فیلد کلید OpenAI API را پیدا کنید. کلید یکپارچه FreeLLMAPI خود را جای‌گذاری کنید. روی Save کلیک کنید.
  4. بازنویسی آدرس پایه OpenAI را روشن کنید. راهنمای FreeLLMAPI این تنظیم را Override OpenAI Base URL می‌نامد.
  5. نشانی عمومی خود را با /v1 در انتها وارد کنید، برای مثال https://<your-tunnel-host>/v1.
  6. یک مدل را در انتخاب‌گر مدل انتخاب کنید و یک پیام کوتاه گفتگو بفرستید.

مستندات حریم خصوصی Cursor به بازنویسی آدرس پایه سازگار با OpenAI اشاره می‌کند. Cursor مراحل دقیق را مستند نکرده است. برچسب‌ها در نسخه شما ممکن است فرق داشته باشند.

برای مطمئن شدن از رسیدن درخواست‌ها به دروازه، گزارش درخواست داشبورد را باز کنید. هر پاسخ همچنین یک هدر X-Routed-Via دارد که ارائه‌دهنده و مدلی را که پاسخ داد نشان می‌دهد.

مهم: تا وقتی بازنویسی روشن است، برای کل برنامه اعمال می‌شود. پیش از بازگشت به ارائه‌دهندگان داخلی Cursor، آن را خاموش کنید.

مرحله 3: انتخاب مدل‌ها

از شناسه مدل auto استفاده کنید تا مسیریاب برای هر درخواست یک مدل رایگان انتخاب کند. می‌توانید شناسه کاتالوگ را از GET /v1/models هم استفاده کنید. گفتگوی Cursor با هر پیام، زمینه فایل را می‌فرستد، پس از مدل‌هایی با پنجره زمینه بزرگ استفاده کنید. جدول، مدل‌های رایگانی را نشان می‌دهد که امروز فراخوانی ابزار و حداقل 128K زمینه دارند.

مدل‌های رایگان برای گفتگوی Cursor: فراخوانی ابزار و زمینه 128K+
مدلرایگان درمتن ورودیمحدودیت‌های رایگان (بهترین پیشنهاد)ابزارهابینایی
GLM 5.3UnoRouter1M1 درخواست در دقیقه
1 req/min per model
بلهخیر
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 درخواست در دقیقه
40 RPM
بلهبله
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaبلهبله
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceبلهخیر
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditبلهبله
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)
بلهبله
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 درخواست در دقیقه
50 درخواست در روز
Shared rate limit
بلهخیر
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 درخواست در دقیقه
250 درخواست در روز
70,000 توکن در دقیقه
~6M
بلهبله

نمایش 10 مدل رایگان مطابق از 109 مدل. مشاهده همه مدل‌ها.

داده‌های زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسی‌شده در 2026-11-19). محدودیت‌های رایگان اغلب تغییر می‌کنند. کاتالوگ هر روز بررسی می‌شود.

Cursor کلیدهای شخصی OpenAI را برای مدل‌های گفتگوی بدون استدلال مستند کرده است. مدل‌های استدلالی ممکن است از طریق بازنویسی شکست بخورند. اگر مدلی شکست خورد، از auto یا مدل دیگری از جدول استفاده کنید.

محدودیت‌های نرخ و جایگزینی

هر سطح رایگان محدودیت در دقیقه و در روز دارد. FreeLLMAPI استفاده از هر کلید را می‌شمارد. وقتی یک ارائه‌دهنده خطای 429 بفرستد، مسیریاب درخواست را به مدل بعدی در زنجیره جایگزینی شما می‌فرستد. گفتگو ادامه پیدا می‌کند و شما تنظیمات Cursor را تغییر نمی‌دهید.

  • کلید از چهار ارائه‌دهنده یا بیشتر اضافه کنید. ارائه‌دهندگان بیشتر، درخواست بیشتری در روز می‌دهند.
  • برای سؤال‌های کوتاه از auto:fast و برای سؤال‌های سخت کد از auto:smart استفاده کنید.
  • برای هر وظیفه یک گفتگوی جدید شروع کنید. تاریخچه کوتاه‌تر توکن کمتری می‌فرستد.

عیب‌یابی

مشکلعلتراه‌حل
Cursor به http://localhost:3001/v1 وصل نمی‌شودCursor درخواست‌ها را از سرورهای خود می‌فرستد، نه از رایانه شمابرای دروازه یک نشانی عمومی HTTPS استفاده کنید
گزینه‌ای برای کلید شخصی نیستطرح Cursor شما کلید شخصی API را شامل نمی‌شودجدول طرح‌ها را در صفحه قیمت Cursor بررسی کنید
401 "Invalid API key"کلیدی که در Cursor است، کلید یکپارچه FreeLLMAPI شما نیستکلید یکپارچه را دوباره از صفحه Keys کپی کنید
تکمیل Tab از دروازه استفاده نمی‌کندCursor برای Tab همیشه از مدل‌های خودش استفاده می‌کندراه‌حلی ندارد. برای تکمیل خودکار رایگان در VS Code از Continue استفاده کنید
"همه مدل‌ها پس از N تلاش به محدودیت نرخ رسیدند"همه کلیدهای زنجیره به حد خود رسیده‌اندکلید از ارائه‌دهندگان بیشتری اضافه کنید، یا تا پایان دوره استراحت صبر کنید
مدل‌های داخلی کار نمی‌کنندبازنویسی آدرس پایه هنوز روشن استبازنویسی را خاموش کنید
هر یک از این‌ها را با یک کلید استفاده کنید. FreeLLMAPI یک روتر متن‌باز و میزبانی‌شده روی سرور خودتان است. این روتر همه این سطوح رایگان را پشت یک نقطه پایانی سازگار با OpenAI قرار می‌دهد و وقتی یک سرویس به محدودیت نرخ برسد، به سرویس بعدی منتقل می‌شود. مرور کاتالوگ یا اجرای زنده.

پرسش‌های متداول

آیا می‌توانم Cursor را با کلید API شخصی خودم رایگان استفاده کنم؟

صفحه قیمت Cursor کلیدهای شخصی API را در طرح‌های Premium، Super و Ultra فهرست می‌کند و می‌گوید طرح Plus کلید شخصی ندارد. در طرحی که کلید شخصی دارد، FreeLLMAPI مدل‌های رایگان را برای گفتگو فراهم می‌کند، پس هزینه استنتاج 0 دلار است.

چرا Cursor به localhost وصل نمی‌شود؟

Cursor برای ساخت prompt همه درخواست‌ها را از طریق سرورهای خودش می‌فرستد. آن سرورها به localhost روی رایانه شما دسترسی ندارند، پس دروازه به یک نشانی عمومی HTTPS نیاز دارد.

آیا تکمیل خودکار Tab در Cursor با یک API سفارشی کار می‌کند؟

خیر. مستندات Cursor می‌گویند که کلیدهای API سفارشی فقط با مدل‌های گفتگو کار می‌کنند و تکمیل Tab همچنان از مدل‌های داخلی Cursor استفاده می‌کند.

کدام مدل رایگان برای Cursor بهتر است؟

از auto استفاده کنید، یا یک مدل از جدول این صفحه با فراخوانی ابزار و حداقل 128K زمینه. Cursor با هر پیام زمینه فایل را می‌فرستد، پس پنجره زمینه بزرگ مهم است.

وقتی از کلید شخصی خودم استفاده می‌کنم، آیا کدم به Cursor فرستاده می‌شود؟

بله. Cursor می‌گوید که درخواست‌ها برای ساخت نهایی prompt از سرورهای آن عبور می‌کنند. نگهداری صفر داده وقتی از کلیدهای شخصی استفاده می‌کنید اعمال نمی‌شود.

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

منابع

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