کلید API برای Cursor؛ اتصال Cursor به 1ai با Override OpenAI Base URL
Cursor اجازه می‌دهد کلید OpenAI خودتان را وارد کنید و آدرس پایه را عوض کنید. با این دو تنظیم می‌توانید در حالت Ask با مدلهای وان ای آی (1ai) و از اعتبار ریالی خودتان گفتگو کنید. اما همهی قابلیت‌های Cursor از این کلید استفاده نمی‌کنند: Tab همیشه با مدل خود Cursor کار میکند و حالت Agent با آدرس سفارشی فعلاً درخواست را در قالبی میفرستد که 1ai نمی‌پذیرد. این راهنما تنظیم دقیق، جدول آن‌چه کار میکند و نمیکند، و راه کامل‌تر برای کار عاملمحور در همان Cursor را می‌گوید.
چرا با 1ai
گفتگو در حالت Ask
پرسش درباره‌ی کد، توضیح فایل، طرح تغییر و بازبینی diff با مدلهای 1ai، داخل همان پنل چت Cursor.
پرداخت ریالی
هزینهی مدل از اعتبار 1ai کم میشود که آن را با پرداخت ریالی می‌خرید؛ کارت ارزی لازم نیست.
سقف مصرف برای کلید Cursor
برای کلیدی که به Cursor می‌دهید سقف ماهانه، مدلهای مجاز و تاریخ انقضا بگذارید و هر وقت لازم شد آن را باطل کنید.
Cline داخل Cursor
برای کار عاملمحور، افزونه‌ی Cline را در خود Cursor نصب کنید؛ با همان کلید 1ai کامل کار میکند.
آدرس عمومی
Cursor درخواست را از سرورهای خودش میفرستد، پس آدرس باید از اینترنت در دسترس باشد؛ `https://1ai.ir/v1` عمومی است.
در چند قدم
- ۱
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Cursor و سقف ماهانه بسازید و کپی کنید.
- ۲
کلید را در Cursor بگذارید
در Cursor Settings به Models بروید، تا بخش API Keys پایین بیایید، OpenAI API Key را روشن کنید و کلید را بچسبانید.
- ۳
آدرس پایه را عوض کنید
گزینه‌ی Override OpenAI Base URL را روشن کنید و `https://1ai.ir/v1` را بنویسید، بدون `/chat/completions` در انتها.
- ۴
مدل سفارشی اضافه کنید
با Add Custom Model شناسه‌ای مثل `qwen/qwen3.8-max` را اضافه و روشن کنید، بعد در چت حالت Ask را بزنید و همان مدل را انتخاب کنید.
مدل‌هایی که می‌توانید در Cursor اضافه کنید
همهی مدلهاGPT-6.1 Sol
پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای
Gemini 3.8 Flash
سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند
Claude Haiku 5.5
سریع‌ترین کلود؛ در سهمیهی رایگان روزانه
سبک و ارزان؛ در سهمیهی رایگان روزانه
DeepSeek V4.1 Flash
سریع و بسیار ارزان؛ در سهمیهی رایگان روزانه
نمونه پرامپت‌ها
پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.
توضیح یک فایل
@[نام فایل] Explain how this file works, which functions it exports and where they are used in the project.
طرح تغییر بدون ویرایش
I want to add [قابلیت موردنظر]. Without editing files, list the files that need to change and describe each change in one or two sentences.
خروجی Ask متن است؛ تغییرها را خودتان یا با Cline اعمال کنید.
بازبینی diff
Review this diff for bugs, missing error handling and naming problems. Answer as a numbered list ordered by severity. [diff را این‌جا بچسبانید]
تبدیل زبان
Rewrite this Python function in TypeScript with proper types and the same behaviour: [کد]
پرسش فارسی
به فارسی توضیح بده در این پروژه تفاوت [روش اول] و [روش دوم] چیست و کدام برای [نیاز شما] مناسب‌تر است. نام فایل‌های مرتبط را هم بگو.
Cursor با کلید 1ai چه کارهایی را انجام می‌دهد؟
| قابلیت Cursor | با کلید 1ai |
|---|---|
| گفتگو در حالت Ask | کار میکند |
| حالت Plan | طبق گزارش کاربران و راهنمای چند درگاه دیگر کار میکند؛ خودتان امتحان کنید |
| حالت Agent | فعلاً نه؛ Cursor با آدرس سفارشی درخواست را در قالب Responses API میفرستد و 1ai فقط Chat Completions دارد |
| تکمیل Tab | نه؛ همیشه با مدل خود Cursor |
| مدلهای خود Cursor مثل Composer و Grok | تا وقتی کلید OpenAI روشن است خطا میدهند |
مستندات Cursor می‌گوید کلید شخصی فقط برای مدلهای چت به کار میرود و درخواستها برای ساختن نهایی پرامپت از سرورهای Cursor عبور می‌کنند؛ کلید همراه هر درخواست فرستاده میشود ولی ذخیره نمیشود. برای همین آدرس باید عمومی باشد و آدرس‌های localhost کار نمی‌کنند.
این وضعیت در آبان ۱۴۰۵ بررسی شده است و Cursor ممکن است آن را تغییر دهد.
تنظیم دقیق Cursor برای 1ai
- Cursor Settings را باز کنید و به Models بروید.
- در بخش API Keys گزینه‌ی OpenAI API Key را روشن کنید و کلید
sk-1ai-…را بچسبانید. اگر Cursor خواست کلید را تأیید کند، Verify را بزنید. - Override OpenAI Base URL را روشن کنید و بنویسید:
https://1ai.ir/v1 - روی Add Custom Model بزنید، شناسه‌ی کامل مدل را بنویسید و کلید کنار آن را روشن کنید.
- چت را با Cmd/Ctrl + L باز کنید، حالت Ask را انتخاب کنید و مدل تازه را برگزینید.
اگر عضو تیم Cursor هستید، ممکن است مدیر تیم باید استفاده از کلید شخصی را در داشبورد تیم مجاز کند.
پیش از آزمایش در Cursor، کلید را در ترمینال امتحان کنید:
curl https://1ai.ir/v1/chat/completions -H "Authorization: Bearer sk-1ai-..." -H "Content-Type: application/json" -d '{"model": "qwen/qwen3.8-max", "messages": [{"role": "user", "content": "Reply with: ok"}]}'کدام مدل را در Cursor اضافه کنیم؟
برای Ask مدل‌هایی را اضافه کنید که در کد قوی‌اند و در فهرست مدلهای گفتگو برچسب tools دارند:
qwen/qwen3.8-maxبرای پرسش‌های سنگین‌تر و چندزبانهdeepseek/deepseek-v4.1-flashبرای پرسش‌های روزمره با هزینهی کمmoonshotai/kimi-k3برای توضیح کدهای طولانیopenai/gpt-6.1-solبرای تحلیل دقیق
Cursor مدلهای Claude و Gemini را با کلیدهای Anthropic و Google خودش مسیردهی میکند و کلید OpenAI روی آن‌ها اثری ندارد. اگر anthropic/claude-sonnet-5.5 یا google/gemini-3.8-flash از مسیر 1ai جواب نداد، این دو را از راه Cline استفاده کنید. Cursor کلید OpenAI را برای «مدلهای چت استاندارد و غیراستدلالی» مستند کرده است؛ اگر یک مدل استدلالی خطا داد، مدل دیگری بگذارید.
خطاهای رایج Cursor با 1ai و راه‌حل
- Missing required parameter: messages یا خطای 400 در Agent: Cursor قالب Responses را فرستاده است؛ به حالت Ask بروید.
- This model does not support custom API keys روی Composer یا Grok: تا وقتی کلید OpenAI روشن است، مدلهای خود Cursor هم از این کلید استفاده می‌کنند. برای آن‌ها کلید OpenAI را خاموش کنید.
- Model name is not valid: کلید OpenAI خاموش مانده و کلید همراه درخواست نرفته است.
- 401
invalid_api_key: کلید اشتباه، باطل یا منقضی است. - 404
model_not_found: شناسه را با پیشوند سازنده بنویسید، مثلqwen/qwen3.8-max. - مسیر تکراری: Base URL را بدون
/chat/completionsبنویسید؛ Cursor خودش مسیر را اضافه میکند. - 402 یا 429: اعتبار یا سقف ماهانه‌ی کلید تمام شده، یا سقف درخواست در دقیقه پر شده است.
- خطای اتصال یا TLS: در Cursor Settings ← Network گزینه‌ی HTTP Compatibility Mode را روی HTTP/1.1 بگذارید.
راه کامل‌تر: Cline یا Continue داخل Cursor
Cursor بر پایه‌ی VS Code ساخته شده و افزونه‌های آن را می‌پذیرد. اگر کار عاملمحور میخواهید (ویرایش چند فایل، اجرای دستور و تست)، افزونه‌ی Cline یا Continue را داخل خود Cursor نصب کنید و همان کلید را به آن بدهید؛ این افزونه‌ها مستقیم با chat/completions و فراخوانی ابزار کار می‌کنند. تنظیمات در راهنمای Cline و راهنمای Continue آمده است.
برای کنترل هزینه، کلید Cursor را از کلید سرورهای خودتان جدا کنید و برایش سقف ماهانه و مدلهای مجاز بگذارید؛ جزئیات در راهنمای کلیدها و کنترل هزینه. توضیح کلی API در صفحه‌ی توسعه‌دهندگان است.
ابزارهای آماده
توضیح کد و رفع باگ
کد را بفهمید، خطایش را پیدا کنید و تمیزش کنید
ساخت عبارت باقاعده (Regex)
الگوی Regex با توضیح و نمونه‌ی آزمون
دستیارهای مرتبط
برنامه‌نویس ارشد
نوشتن، مرور و اشکال‌زدایی کد با توضیح روشن
- «این کد را مرور کن و باگ‌ها و مشکلات امنیتی‌اش را بگو: »
- «یک API ساده برای مدیریت کارها با Node.js و Express بنویس»
سوالات متداول
چرا حالت Agent در Cursor با کلید 1ai کار نمیکند؟
وقتی آدرس پایه عوض شده باشد، Cursor در حالت Agent بدنهی درخواست را به شکل Responses API (با فیلد input به جای messages) به مسیر chat/completions میفرستد. 1ai فقط Chat Completions را پشتیبانی میکند و چنین درخواستی را رد میکند. تیم Cursor این مشکل را در انجمن خود پذیرفته است؛ تا وقتی رفع نشده، از Ask یا از Cline استفاده کنید.
Tab در Cursor هم از اعتبار 1ai استفاده میکند؟
خیر. طبق مستندات Cursor، تکمیل Tab همیشه با مدلهای خود Cursor و در چارچوب اشتراک Cursor کار میکند و به کلید شخصی وصل نمیشود.
کلید من در سرورهای Cursor ذخیره میشود؟
به گفتهی Cursor، کلید همراه هر درخواست به سرورهای آن میرود ولی ذخیره نمیشود. با این حال برای Cursor کلید جداگانه بسازید تا اگر لازم شد، فقط همان را باطل کنید و سرویسهای دیگرتان از کار نیفتند.
بعد از روشن کردن Override، مدلهای خود Cursor خطا میدهند؛ چه کنم؟
کلید OpenAI و آدرس سفارشی روی همهی مدلهای غیر از Claude و Gemini اثر میگذارد، از جمله Composer و Grok. هر وقت این مدلها را لازم دارید، کلید OpenAI را در Models خاموش کنید و برای مدلهای 1ai دوباره روشن کنید.
هزینه از اشتراک Cursor کم میشود یا از اعتبار 1ai؟
هزینهی مدل از اعتبار 1ai کم میشود. طبق مستندات Cursor، در پلنهای فردی درخواستهای کلید شخصی از سهمیهی Cursor کم نمیشود، ولی در پلنهای تیمی ممکن است Cursor برای همین درخواستها هزینهی جداگانهی خودش را حساب کند.
Cursor را نگه دارم یا به VS Code با Cline بروم؟
اگر رابط Cursor و Tab آن را دوست دارید، Cursor را نگه دارید و Cline را داخلش نصب کنید تا کارهای عاملمحور با اعتبار 1ai انجام شود. اگر میخواهید همهی مصرف از یک جا و با یک کلید باشد، VS Code با Cline یا Continue سادهتر است.
مطالب مرتبط
استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدلها و مدیریت خطا.
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدلهای مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی
LLM موتور بسیاری از دستیارهای هوش مصنوعی است. با مثال‌های ساده، سازوکار آن، تفاوت مدلهای باز و بسته و روش انتخاب مدل مناسب برای متن و کارهای فارسی را بشناسید.
صفحه‌های مرتبط
همهی امکاناتاتصال Cline
افزونه‌ی Cline را با گزینه‌ی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.
اتصال Continue
Continue را با چند خط config.yaml به API سازگار با OpenAI در 1ai وصل کنید و برای چت، ویرایش، Agent و تکمیل خودکار مدل جداگانه بگذارید.
برنامه‌نویسی با هوش مصنوعی
کد بنویسید، خطا پیدا کنید، SQL و Regex بسازید و با API سازگار با OpenAI مدلها را به ابزارهای خودتان وصل کنید.
کلید API برای Cursor؛ اتصال Cursor به 1ai با Override OpenAI Base URL
کلید 1ai را در Cursor بگذارید و در حالت Ask با Qwen، DeepSeek، Kimi و GPT گفتگو کنید؛ با توضیح صریح این‌که Tab و Agent چه وضعیتی دارند.
ساخت کلید API