آموزش اتصال Cursor IDE به API هوش مصنوعی با پرداخت ریالی

چرا Cursor را به کایا وصل کنیم؟

Cursor به شما اجازه می‌دهد مدل دلخواه را با کلید و Base URL سفارشی اضافه کنید. کایا ای آی دقیقاً همان مسیر OpenAI را پیاده کرده است، پس Cursor بدون دستکاری خاصی به آن وصل می‌شود و همه درخواست‌ها از داخل ایران و بدون تحریم‌شکن ارسال می‌شوند.

به این ترتیب به کارت بانکی بین‌المللی یا اشتراک دلاری نیاز ندارید؛ اعتبار را ریالی شارژ می‌کنید و هزینه هر درخواست بر اساس مصرف واقعی توکن از کیف پول شما کسر می‌شود.

• پشتیبانی از مدل سفارشی و Base URL سفارشی در Cursor Settings → Models
• سازگاری کامل با فرمت OpenAI: POST /api/v1/chat/completions
• پرداخت ریالی بر اساس مصرف، بدون اشتراک ماهانه
• بدون نیاز به پروکسی روی اینترنت ایران

پیش از شروع

• یک کلید API از پنل کلیدها بسازید و کپی کنید
• مطمئن شوید اعتبار کافی دارید؛ با ۱۰۰ اعتبار هدیه ثبت‌نام شروع کنید
• Cursor را از cursor.com نصب و به حساب خود وارد کنید

تنظیم Cursor در پنج گام

1. ۱

   Cursor Settings را باز کنید و به تب Models بروید

   در Cursor از منوی Cursor → Settings → Cursor Settings وارد تنظیمات شوید (میان‌بر Ctrl/Cmd + Shift + J) و تب Models را انتخاب کنید. همه تنظیمات این راهنما در همین تب است.

2. ۲

   Add Model را بزنید و شناسه مدل‌ها را اضافه کنید

   در بخش مدل‌ها روی Add model (یا + Add model) کلیک کنید و شناسه کامل مدل را وارد کنید. سه شناسه پیشنهادی ما را یکی‌یکی اضافه کنید:

   شناسه مدل‌های پیشنهادیکپی

   deepseek/deepseek-v4.1-flash
   anthropic/claude-sonnet-5.5
   openai/gpt-6.1-sol

   شناسه مدل باید دقیقاً مطابق کاتالوگ کایا باشد. فهرست کامل در صفحه مدل‌ها است؛ می‌توانید هر مدل چت دیگری را هم اضافه کنید.

3. ۳

   OpenAI API Key را وارد کنید

   در همان تب Models، بخش OpenAI API Key را پیدا کنید، کلید کایا را بچسبانید و مطمئن شوید سوییچ آن روشن (On) است. Cursor برای مدل‌های سفارشی که با OpenAI سازگارند از همین کلید استفاده می‌کند.

   OpenAI API Keyکپی

   sk-llm-YOUR_KEY

4. ۴

   Override OpenAI Base URL را روی آدرس کایا بگذارید

   در بخش Override OpenAI Base URL این آدرس را وارد کنید و دکمه Verify را بزنید:

   Override OpenAI Base URLکپی

   https://kayaai.ir/api/v1

   آدرس را بدون /chat/completions وارد کنید؛ Cursor خودش مسیر کامل را می‌سازد. دکمه Verify باید پیام موفقیت بدهد و مدل‌های اضافه‌شده سبزرنگ (فعال) شوند.

5. ۵

   مدل را در Chat انتخاب و تست کنید

   در پنل چت (یا Ctrl/Cmd + L) از منوی انتخاب مدل، یکی از مدل‌های کایا را انتخاب کنید و یک درخواست ساده بفرستید. اگر پاسخ آمد، اتصال برقرار است. در حالت Agent هم همین مدل انتخابی استفاده می‌شود.

   تست کلید با cURL (اختیاری)کپی

   curl https://kayaai.ir/api/v1/chat/completions \
     -H "Authorization: Bearer sk-llm-YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "deepseek/deepseek-v4.1-flash",
       "messages": [{"role": "user", "content": "سلام"}]
     }'

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

Cursor اجازه می‌دهد در هر لحظه مدل را از منوی چت عوض کنید. ترکیب پیشنهادی ما: ویرایش‌های پرتعداد با deepseek/deepseek-v4.1-flash، کار روزمره و Agent با anthropic/claude-sonnet-5.5 و تحلیل‌های سنگین با openai/gpt-6.1-sol.

• مصرف بالا و ارزان: deepseek/deepseek-v4.1-flash
• تعادل کیفیت و هزینه: anthropic/claude-sonnet-5.5
• استدلال پیچیده: openai/gpt-6.1-sol
• هر مدل دیگری از کاتالوگ را می‌توانید با Add Model اضافه کنید

چه چیزهایی از کلید شما استفاده نمی‌کنند؟

در Cursor دو قابلیت مستقل وجود دارد که با کلید API شما کار نمی‌کنند: تکمیل خودکار Tab و مدل Fast Apply. این قابلیت‌ها روی سرورهای خود Cursor اجرا می‌شوند.

بنابراین اگر فقط می‌خواهید Chat، Composer و Agent را با مدل‌های کایا اجرا کنید، کلید و Base URL سفارشی کافی است. برای Tab نیازی به سرویس هوش مصنوعی جداگانه ندارید و می‌توانید آن را خاموش بگذارید.

عیب‌یابی سریع