اتصال Cursor به پیکو هوش

Cursor یک ویرایشگر کد مبتنی بر VS Code با چت و تکمیل هوشمند است. در تنظیمات مدل‌ها می‌توانید کلید OpenAI خودتان را وارد کنید و آدرس پایه‌ی OpenAI را تغییر دهید. با این کار درخواست‌های چت Cursor به دروازه‌ی پیکو هوش می‌رود و می‌توانید مدل دلخواه کاتالوگ را اضافه کنید.

رابط Cursor به‌روزرسانی می‌شود و نام منوها ممکن است تغییر کند. اگر گزینه‌ای را در جای گفته‌شده نیافتید، در تنظیمات به دنبال Models و Override OpenAI Base URL بگردید. برخی قابلیت‌های اختصاصی Cursor با مدل‌های سفارشی محدودیت دارند.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱باز کردن تنظیمات مدل‌ها

   در Cursor به Settings و سپس بخش Models بروید.

2. ۲وارد کردن کلید و آدرس

   گزینه‌ی OpenAI API Key را فعال کنید، کلید پیکو هوش را وارد کنید و Override OpenAI Base URL را روشن کنید.

   کپی

   OpenAI API Key:  YOUR_API_KEY
   Override OpenAI Base URL:  https://api.picoai.ir/v1

3. ۳افزودن مدل

   با Add Model نام دقیق مدل را از کاتالوگ بنویسید (مثلاً claude-sonnet-5-5) و تیک آن را بزنید.

   کپی

   claude-sonnet-5-5

4. ۴تأیید کلید

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

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Cursor خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Cursor

• برای کدنویسی روزمره مدل‌های توانمند در کد و برای تکمیل‌های سبک مدل‌های سریع‌تر را انتخاب کنید.
• مصرف توکن در ویرایشگرها بالاست چون زمینه‌ی فایل‌ها هم ارسال می‌شود؛ در داشبورد پیکو هوش سقف ماهانه برای کلید خاص Cursor بگذارید.
• کلید جداگانه برای Cursor بسازید تا مصرف آن را مستقل ببینید و در صورت نیاز غیرفعالش کنید.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.