استفاده از 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، صفحه مدلهای شخص ثالث را غیرقابل استفاده نشان میدهد. پیش از ادامه، صفحه قیمت را برای طرح خود بررسی کنید.
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
- Cursor Settings را باز کنید.
- Models را باز کنید.
- فیلد کلید OpenAI API را پیدا کنید. کلید یکپارچه FreeLLMAPI خود را جایگذاری کنید. روی Save کلیک کنید.
- بازنویسی آدرس پایه OpenAI را روشن کنید. راهنمای FreeLLMAPI این تنظیم را Override OpenAI Base URL مینامد.
- نشانی عمومی خود را با
/v1در انتها وارد کنید، برای مثالhttps://<your-tunnel-host>/v1. - یک مدل را در انتخابگر مدل انتخاب کنید و یک پیام کوتاه گفتگو بفرستید.
مستندات حریم خصوصی Cursor به بازنویسی آدرس پایه سازگار با OpenAI اشاره میکند. Cursor مراحل دقیق را مستند نکرده است. برچسبها در نسخه شما ممکن است فرق داشته باشند.
برای مطمئن شدن از رسیدن درخواستها به دروازه، گزارش درخواست داشبورد را باز کنید. هر پاسخ همچنین یک هدر X-Routed-Via دارد که ارائهدهنده و مدلی را که پاسخ داد نشان میدهد.
مرحله 3: انتخاب مدلها
از شناسه مدل auto استفاده کنید تا مسیریاب برای هر درخواست یک مدل رایگان انتخاب کند. میتوانید شناسه کاتالوگ را از GET /v1/models هم استفاده کنید. گفتگوی Cursor با هر پیام، زمینه فایل را میفرستد، پس از مدلهایی با پنجره زمینه بزرگ استفاده کنید. جدول، مدلهای رایگانی را نشان میدهد که امروز فراخوانی ابزار و حداقل 128K زمینه دارند.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 درخواست در دقیقه 1 req/min per model | بله | خیر |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 درخواست در دقیقه 40 RPM | بله | بله |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | بله | بله |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | بله | خیر |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| 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) | بله | بله |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 درخواست در دقیقه 50 درخواست در روز Shared rate limit | بله | خیر |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 درخواست در دقیقه 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 تلاش به محدودیت نرخ رسیدند" | همه کلیدهای زنجیره به حد خود رسیدهاند | کلید از ارائهدهندگان بیشتری اضافه کنید، یا تا پایان دوره استراحت صبر کنید |
| مدلهای داخلی کار نمیکنند | بازنویسی آدرس پایه هنوز روشن است | بازنویسی را خاموش کنید |
پرسشهای متداول
آیا میتوانم 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 از سرورهای آن عبور میکنند. نگهداری صفر داده وقتی از کلیدهای شخصی استفاده میکنید اعمال نمیشود.
راهنماهای مرتبط
- مدلهای هوش مصنوعی رایگان در VS Code
- Cline، Roo Code و Kilo Code با یک API رایگان
- Continue با API رایگان LLM
- بهترین API مدلهای کدنویسی رایگان
- آدرسهای پایه API سازگار با OpenAI رایگان
منابع
- Cursor help: API keys (بررسیشده در 20 November 2026)
- Cursor docs: models and pricing (بررسیشده در 20 November 2026)
- Cursor docs: privacy and data governance (بررسیشده در 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (بررسیشده در 20 November 2026)
- FreeLLMAPI CLI generators (بررسیشده در 20 November 2026)