Cursor

با Override OpenAI Base URL در Cursor مدل‌های GPT کاتالوگ OneProvider را در Ask و Agent اجرا کنید.

ویرایشگر کد هوش مصنوعی Cursor

چه چیزی کار می‌کند

درخواست‌های Ask و Agent برای شناسه‌های مدل GPT که اضافه می‌کنید از OneProvider می‌گذرند، از جمله درخواست‌های استریمیِ ApplyPatch. Cursor این درخواست‌ها را از سرورهای خودش می‌فرستد، پس فقط endpoint عمومی کار می‌کند؛ Cursor همچنان محیط اجرای عامل و قابلیت‌های میزبانی‌شدهٔ تخصصی خود را کنترل می‌کند.

محدودیت کلاینت

به طرح پولی Cursor (Pro یا بالاتر) نیاز دارد: از ژانویهٔ 2026 Cursor در طرح Free کلیدهای خودتان را نادیده می‌گیرد. Override سراسری است — تا وقتی روشن است، هر مدلی جز مدل‌های Anthropic و Google، از جمله مدل‌های GPT، Composer و Grok خود Cursor، به OneProvider فرستاده می‌شود؛ برای استفادهٔ دوباره از مدل‌های Cursor آن را خاموش کنید. شناسه‌های داخلی Anthropic/Claude و Google هرگز از Override استفاده نمی‌کنند و تکمیل Tab و قابلیت‌های میزبانی‌شدهٔ Cursor مسیردهی عادی خود را حفظ می‌کنند.

راه‌اندازی

1. به‌روزرسانی Cursor و آماده‌سازی کلید اختصاصی

   آخرین نسخهٔ پایدار Cursor را روی طرح Pro یا بالاتر به کار ببرید. یک کلید اختصاصی OneProvider بسازید، مدل‌ها و مصرف آن را محدود کنید و پیش از بررسی موجودی را شارژ کنید.

2. روشن کردن OpenAI API Key

   Cursor Settings → Models → API Keys را باز کنید، کلید اختصاصی OneProvider را در OpenAI API Key جایگذاری کنید و سوئیچ آن را روشن کنید — جایگذاری کلید به‌تنهایی آن را فعال نمی‌کند.

   OpenAI API Key: sk-your-key-here

3. Override کردن base URL مربوط به OpenAI

   Override OpenAI Base URL (بازنویسی آدرس پایهٔ OpenAI) را روشن کنید و دقیقاً https://api.oneprovider.dev/v1 را وارد کنید — با /v1 و بدون /chat/completions؛ Cursor مسیر را خودش اضافه می‌کند. Cursor شناسهٔ مدل OpenAI سازگار می‌خواهد؛ یک شناسهٔ مدل متنی GPT را از کاتالوگ مدل‌ها انتخاب کنید (مدل تصویر در گفتگو کار نمی‌کند).

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. ذخیره و انتخاب مدل سازگار

   کلید OpenAI و base URL را ذخیره کنید. اگر شناسهٔ مدل سازگاری که انتخاب کرده‌اید در فهرست نیست، آن را به‌عنوان مدل سفارشی اضافه کنید، سپس یک درخواست جدید Ask یا Agent اجرا کنید. شناسه‌های مدل Claude و Google از این Override نمی‌گذرند. وقتی دوباره مسیردهی عادی OpenAI در Cursor را می‌خواهید، Override را خاموش کنید.

بررسی اتصال

تأیید درخواست در داشبورد

درخواست باید gpt-6.1-terra، endpoint سازگار با OpenAI، مصرف توکن و مبلغ کسرشده را نشان دهد. اگر Cursor به‌جای آن خطا نشان داد:

"does not work with your current plan or api key" → ⁧طرح Free یا سوئیچ OpenAI API Key خاموش است⁩
"Model name is not valid" → ⁧سوئیچ OpenAI API Key را روشن کنید و گفتگوی جدید شروع کنید⁩
404 / "Invalid URL" → ⁧base URL باید دقیقاً https://api.oneprovider.dev/v1 باشد⁩
401 → ⁧کلید OneProvider اشتباه، باطل‌شده یا بدون موجودی است⁩
"model … is not available" → ⁧شناسهٔ مدل در کاتالوگ OneProvider نیست⁩
⁧مدل‌های خود Cursor خطا می‌دهند⁩ → ⁧تا وقتی از آن‌ها استفاده می‌کنید Override OpenAI Base URL را خاموش کنید⁩

مشخصات اتصال

پروتکل

openai-chat

Endpoint

https://api.oneprovider.dev/v1

امنیت کلید

Cursor درخواست‌ها را از طریق سرویس خودش می‌سازد، پس کلید را به IP ایستگاه کاری خود محدود نکنید. کلید اختصاصی با کنترل‌های مدل، نرخ، مصرف، انقضا و دامنهٔ دسترسی را ترجیح دهید.

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

Override فقط شناسه‌های مدل به سبک OpenAI را عبور می‌دهد، پس یک مدل متنی GPT انتخاب کنید. gpt-6.1-terra پیش‌فرض متعادل برای Ask و Agent است. gpt-6.1-sol ردهٔ پیشرو برای کارهای دشوار چندفایلی و gpt-5.6-luna ردهٔ کم‌هزینه برای پرسش‌های سریع است. شناسه‌ای را که انتخاب کرده‌اید دقیقاً همان‌طور که در کاتالوگ نوشته شده، به‌عنوان مدل سفارشی اضافه کنید. شناسه‌های Claude هرگز از این Override نمی‌گذرند: برای استفاده از Claude، Claude Code را کنار Cursor اجرا کنید.

خطاهای رایج و راه‌حل‌ها

«Model name is not valid»

سوئیچ OpenAI API Key خاموش است یا مدل پیش از روشن شدن آن اضافه شده بود. سوئیچ را روشن کنید، ذخیره کنید و گفتگوی جدید شروع کنید.

«Does not work with your current plan or api key»

در طرح Free هستید یا سوئیچ خاموش است. Cursor در طرح Free کلیدهای خودتان را نادیده می‌گیرد؛ Pro یا بالاتر لازم است.

404 یا «Invalid URL»

https://api.oneprovider.dev/v1 را دقیقاً وارد کنید: با /v1 و بدون /chat/completions. Cursor مسیر را اضافه می‌کند.

401

کلید اشتباه یا باطل‌شده است یا موجودی تمام شده است. کلید را کامل و بدون فاصله جایگذاری کنید و حساب کاربری را شارژ کنید.

مدل‌های خود Cursor با روشن بودن Override خطا می‌دهند

Override سراسری است: هر مدلی که از Anthropic و Google نباشد به OneProvider می‌رود. برای استفادهٔ دوباره از مدل‌های Cursor، Override OpenAI Base URL را خاموش کنید.

درخواست‌ها در داشبورد من دیده نمی‌شوند

مدلی که به کار برده‌اید از Claude یا Google است، یا Override خاموش است. شناسهٔ GPT اضافه‌شده را انتخاب کنید و یک درخواست جدید Ask یا Agent اجرا کنید.

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

تکمیل Tab تحت تأثیر قرار می‌گیرد؟

نه. Tab و قابلیت‌های میزبانی‌شده در Cursor مسیردهی عادی خود را حفظ می‌کنند.

می‌توانم کلید را به IP خودم محدود کنم؟

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

می‌توانم از طریق OneProvider در Cursor از مدل‌های Claude استفاده کنم؟

از طریق این Override نه. برای Claude از Claude Code یا Cline استفاده کنید.

چطور برگردم؟

Override OpenAI Base URL را خاموش کنید. بقیهٔ تنظیمات شما می‌ماند.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .