API هوش مصنوعی

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

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

۱ سیستم‌عامل

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

۲ برنامه

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

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

۳ افزونه

Cline
دستیار کدنویسی
Roo Code
دستیار کدنویسی
Continue
گفتگو و تکمیل کد
Codex
افزونه‌ی رسمی OpenAI

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

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

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

راهنمای اتصال Roo Code

Windows · ۵ قدم
  1. ۱

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

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

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

  2. ۲

    نصب افزونه

    در VS Code بخش Extensions را باز کنید (Ctrl+Shift+X)، عبارت Roo Code را جستجو و نصب کنید. بعد از نصب، آیکن Roo Code در نوار کناری ظاهر می‌شود.

  3. ۳

    انتخاب ارائه‌دهنده

    پنل Roo Code را باز کنید و به تنظیمات آن بروید (آیکن چرخ‌دنده). در فیلد API Provider گزینه‌ی OpenAI Compatible را انتخاب کنید.

  4. ۴

    وارد کردن آدرس، کلید و مدل

    Base URL 
    https://api.2928.ir/v1
    API Key 
    sk-...
    Model ID 
    claude-sonnet-5

    اگر بخش Model Configuration دارد، گزینه‌ی پشتیبانی از تصویر (Supports Images) را برای مدل‌های Claude و GPT روشن بگذارید.

  5. ۵

    ذخیره و تست

    تنظیمات را ذخیره کنید (Save / Done) و در پنل یک پیام کوتاه مثل say hi بفرستید.

خطاهای رایج

401 (Unauthorized)
کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
403 (اعتبار تمام شده)
اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
503 — model_not_found
نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
404 (Not Found)
آدرس پایه باید https://api.2928.ir/v1 باشد. خود برنامه مسیر /chat/completions را اضافه می‌کند؛ آن را به آدرس اضافه نکنید.
پاسخ دیر شروع می‌شود
مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

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

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