API هوش مصنوعی

اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

Windows
ویندوز ۱۰ و ۱۱
macOS
مک
Linux
اوبونتو، فدورا و…
Android
گوشی و تبلت اندروید

۲ برنامه

Claude Code
ایجنت کدنویسی Anthropic در ترمینال
Cursor
ویرایشگر کد هوشمند
VS Code
ویرایشگر + افزونه
Codex CLI
ایجنت کدنویسی OpenAI در ترمینال
Cherry Studio
اپ چت دسکتاپ (جایگزین اپ ChatGPT/Claude)

برای اپ رسمی Claude فقط مدل‌های Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.

کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.

وارد شوید تا بتوانید همین‌جا کلید بسازید.

ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.

راهنمای اتصال Cursor

Windows · ۷ قدم
  1. ۱

    انتخاب یا ساخت کلید API

    از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.

    کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.

  2. ۲

    باز کردن Cursor Settings

    Cursor را باز کنید و از آیکن چرخ‌دنده در گوشه‌ی بالای پنجره، Cursor Settings را باز کنید (در بیشتر نسخه‌ها کلیدهای Ctrl+Shift+J). سپس بخش Models را انتخاب کنید.

  3. ۳

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

    در بخش Models قسمت API Keys را باز کنید و کلید را در فیلد OpenAI API Key بچسبانید.

    OpenAI API Key
    sk-...
  4. ۴

    تغییر آدرس پایه (Override OpenAI Base URL)

    گزینه‌ی Override OpenAI Base URL را روشن کنید و آدرس زیر را وارد کنید:

    Base URL
    https://api.2928.ir/v1
  5. ۵

    افزودن مدل سفارشی

    در فهرست مدل‌ها گزینه‌ی Add Model (یا Add Custom Model) را بزنید، نام مدل زیر را دقیقاً همین‌طور وارد کنید و آن را روشن کنید:

    Model
    claude-sonnet-5

    بهتر است مدل‌های دیگر OpenAI را در همین فهرست خاموش کنید تا Cursor آن‌ها را با کلید شما صدا نزند؛ نام آن مدل‌ها در سرویس ما وجود ندارد و خطا می‌گیرید.

  6. ۶

    بررسی کلید (Verify)

    روی دکمه‌ی Verify کنار کلید بزنید. اگر پیام موفقیت دیدید، کلید و آدرس درست است.

  7. ۷

    استفاده در 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 استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

بگویید در کدام قدم ماندید و متن خطا را بفرستید.

تماس با پشتیبانی