اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
برای اپ رسمی Claude فقط مدلهای Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال Cursor
macOS · ۷ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمهی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر میشوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده میشود. آن را در جای امنی نگه دارید و در گروهها یا اسکرینشاتها منتشر نکنید.
-
۲
باز کردن Cursor Settings
Cursor را باز کنید و از آیکن چرخدنده در گوشهی بالای پنجره، Cursor Settings را باز کنید (در بیشتر نسخهها کلیدهای
Ctrl+Shift+J). سپس بخش Models را انتخاب کنید. -
۳
وارد کردن کلید در OpenAI API Key
در بخش Models قسمت API Keys را باز کنید و کلید را در فیلد OpenAI API Key بچسبانید.
OpenAI API Keysk-... -
۴
تغییر آدرس پایه (Override OpenAI Base URL)
گزینهی Override OpenAI Base URL را روشن کنید و آدرس زیر را وارد کنید:
Base URLhttps://api.2928.ir/v1
-
۵
افزودن مدل سفارشی
در فهرست مدلها گزینهی Add Model (یا Add Custom Model) را بزنید، نام مدل زیر را دقیقاً همینطور وارد کنید و آن را روشن کنید:
Modelclaude-sonnet-5
بهتر است مدلهای دیگر OpenAI را در همین فهرست خاموش کنید تا Cursor آنها را با کلید شما صدا نزند؛ نام آن مدلها در سرویس ما وجود ندارد و خطا میگیرید.
-
۶
بررسی کلید (Verify)
روی دکمهی Verify کنار کلید بزنید. اگر پیام موفقیت دیدید، کلید و آدرس درست است.
-
۷
استفاده در Chat
پنل Chat را باز کنید (
Ctrl+L)، از فهرست مدلهای پایین کادر گفتگو مدل سفارشی خود را انتخاب کنید و یک پیام کوتاه مثلsay hiبفرستید.برخی قابلیتهای خود Cursor مثل Tab ممکن است همچنان از مدلهای خود Cursor استفاده کنند؛ مدل سفارشی برای گفتگو و ویرایش است.
خطاهای رایج
- 401 (Unauthorized)
- کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
- 403 (اعتبار تمام شده)
- اعتبار حساب تمام یا منقضی شده است. از صفحهی «خرید اعتبار» بسته بخرید یا تمدید کنید.
- 503 — model_not_found
- نام مدل اشتباه است. نام را دقیقاً از صفحهی «مدلها» کپی کنید.
- 404 (Not Found)
- آدرس پایه باید
https://api.2928.ir/v1باشد. خود برنامه مسیر/chat/completionsرا اضافه میکند؛ آن را به آدرس اضافه نکنید. - پاسخ دیر شروع میشود
- مدلهای بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا دهها ثانیه قبل از شروع پاسخ فکر میکنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.