راهنمای ابزار

اتصال Cursor به مرشد API

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

قدم ساده
۵
قدم ساده
نسخهٔ آزمایش‌شده
3.27
نسخهٔ آزمایش‌شده
اشتراک Cursor لازم است
پولی
اشتراک Cursor لازم است
پرداخت مدل از کیف پول
ریالی
پرداخت مدل از کیف پول

پیش از شروع

در پلن رایگان Cursor کار نمی‌کند

ما این مراحل را در Cursor 3.27 روی پلن رایگان انجام دادیم. همهٔ تنظیمات ذخیره شد و مدل مرشد در فهرست آمد، ولی با فرستادن اولین پیام (در حالت Agent و Ask) Cursor پیام Cursor Subscription Required را نشان داد و درخواستی نفرستاد. پس اگر اشتراک پولی Cursor ندارید، سراغ راهنمای Cline یا راهنمای VS Code بروید.
پیام Cursor Subscription Required در پلن رایگان Cursor هنگام فرستادن پیام با deepseek-v4-pro
پیامی که Cursor در پلن رایگان نشان می‌دهد.

کیف پول را شارژ کنید

در پنل مرشد API صفحهٔ «اعتبار و خرید» را باز کنید و روی «خرید اعتبار» بزنید. پرداخت با درگاه زرین‌پال است و هزینهٔ هر پیام از همین اعتبار کم می‌شود.

صفحهٔ «اعتبار و خرید» در پنل مرشد API با دکمهٔ «خرید اعتبار»
صفحهٔ «اعتبار و خرید» در پنل. دکمهٔ «خرید اعتبار» را بزنید.
رفتن به «اعتبار و خرید»

یک کلید API بسازید

به صفحهٔ «کلیدهای API» بروید و «ساخت کلید جدید» را بزنید. یک نام مثل Cursor بنویسید و «ساخت کلید» را بزنید.

تصویر متحرک: باز کردن صفحهٔ کلیدها، زدن «ساخت کلید جدید»، نوشتن نام و دیدن کلید ساخته‌شده
ساخت کلید جدید در پنل، از اول تا آخر.

کلید فقط یک بار کامل نشان داده می‌شود

همان لحظه دکمهٔ «کپی» را بزنید. کلید را به کسی ندهید و جایی منتشر نکنید، چون هرکس آن را داشته باشد از اعتبار شما خرج می‌کند. اگر کلید گم شد، یک کلید تازه بسازید و کلید قبلی را از همان صفحه ابطال کنید.
رفتن به «کلیدهای API»

کلید و آدرس مرشد را در Cursor بگذارید

در Cursor روی چرخ‌دندهٔ بالا سمت راست پنجره (Open Cursor Settings) بزنید و از فهرست کنار صفحه Models را باز کنید. پایین صفحه بخش API Keys را باز کنید. زیر عنوان OpenAI API Key این سه کار را انجام دهید:

  1. کلیدی را که در قدم ۲ کپی کردید در فیلد API Key بچسبانید.
  2. گزینهٔ Override OpenAI Base URL را روشن کنید و در فیلد Base URL این آدرس را بنویسید: https://api.morshed.ai/v1
  3. گزینهٔ Use OpenAI API Key را روشن کنید. Cursor یک پنجرهٔ تأیید نشان می‌دهد. روی Enable OpenAI API Key بزنید.
تنظیمات Cursor، بخش API Keys: کلید در فیلد API Key، گزینه‌های Use OpenAI API Key و Override OpenAI Base URL روشن و Base URL برابر https://api.morshed.ai/v1
بخش OpenAI API Key بعد از تنظیم. کلید به شکل نقطه دیده می‌شود.
پنجرهٔ تأیید Enable OpenAI API Key در Cursor با دکمهٔ Enable OpenAI API Key
پنجرهٔ تأیید. روی Enable OpenAI API Key بزنید.

چرا «OpenAI»؟

مرشد API با استاندارد OpenAI سازگار است. برای همین کلید مرشد را در بخش OpenAI می‌گذارید، ولی با تغییر Base URL درخواست‌ها به مرشد می‌روند، نه به OpenAI.

مدل مرشد را اضافه کنید

در همان صفحهٔ Models، در کادر Add or search model شناسهٔ مدل را بنویسید، مثلاً deepseek-v4-pro. روی Add Custom Model بزنید و بعد Add را بزنید.

بخش Models در تنظیمات Cursor: deepseek-v4-pro در کادر Add Custom Model نوشته شده و دکمهٔ Add کنارش است
نوشتن شناسهٔ مدل و زدن Add.

مدل به فهرست اضافه می‌شود و کلیدش روشن است.

فهرست مدل‌های Cursor که deepseek-v4-pro در آن اضافه و روشن شده
deepseek-v4-pro در فهرست مدل‌ها، روشن.

شناسهٔ دقیق مدل

شناسه را دقیقاً از صفحهٔ مدل‌ها کپی کنید. برای مدل دوم همین کار را با شناسهٔ آن تکرار کنید.

مدل را در چت انتخاب کنید

پنل چت Cursor را باز کنید و روی نام مدل پایین کادر پیام بزنید. گزینهٔ Auto را خاموش کنید تا فهرست کامل بیاید، و از پایین فهرست deepseek-v4-pro را انتخاب کنید.

فهرست انتخاب مدل در چت Cursor با Auto خاموش و deepseek-v4-pro پایین فهرست
Auto خاموش و deepseek-v4-pro پایین فهرست.

حالا کارتان را بنویسید. اگر حساب Cursor شما اشتراک پولی دارد، درخواست با کلید مرشد فرستاده می‌شود و هزینهٔ مدل از کیف پول مرشد کم می‌شود. هزینهٔ تک‌تک درخواست‌ها را در صفحهٔ «فعالیت‌ها» پنل ببینید.

چند نکتهٔ مهم

اشتراک پولی Cursor لازم است

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

همهٔ بخش‌های Cursor از مرشد استفاده نمی‌کنند

طبق پیام خود Cursor، بخش‌هایی مثل Tab (پیشنهاد خودکار هنگام تایپ) و Apply from Chat با مدل‌های خود Cursor کار می‌کنند و با کلید شخصی حساب نمی‌شوند.

برگشتن به مدل‌های خود Cursor

گزینهٔ Use OpenAI API Key را خاموش کنید. کلید ذخیره‌شده پاک نمی‌شود و هر وقت خواستید دوباره روشنش کنید.

اشتراک Cursor ندارید؟

Cline و چت خود VS Code بدون اشتراک جداگانه با مرشد API کار می‌کنند و هزینه فقط از کیف پول مرشد کم می‌شود.

رفع مشکل

اگر چیزی کار نکرد، اول این جدول را ببینید.

پیام Cursor Subscription Requiredحساب Cursor شما روی پلن رایگان است.اشتراک پولی Cursor را فعال کنید، یا از Cline یا چت VS Code استفاده کنید که اشتراک جداگانه نمی‌خواهند.
خطای 401 (کلید نامعتبر)کلید ناقص کپی شده یا باطل شده است.یک کلید تازه بسازید و در فیلد API Key بخش OpenAI API Key جایگزین کنید.
خطای 402 (اعتبار کافی نیست)موجودی کیف پول مرشد برای این درخواست کم است.کیف پول را شارژ کنید. مرشد برای هر درخواست کمی از اعتبار را موقتاً کنار می‌گذارد، پس پیش از رسیدن به صفر هم ممکن است این خطا را ببینید.
خطای 404 (پیدا نشد)نام مدل با شناسهٔ مرشد یکی نیست یا Base URL اشتباه است.نام مدل را دقیقاً از صفحهٔ مدل‌ها کپی کنید. Base URL باید دقیقاً https://api.morshed.ai/v1 باشد.

کدهای خطا را کامل در بخش خطاهای مستندات ببینید.

بازگشت به مستندات
راهنمای اتصال Cursor به مرشد API · مرشد API