اتصال Roo Code به API هوش مصنوعی 1ai؛ راهنمای OpenAI Compatible
Roo Code یک دستیار عامل‌محور برنامه‌نویسی در VS Code است که از Cline منشعب شده و حالت‌های مختلفی مثل Code، Architect و Ask دارد. خودش مدلی ندارد و به یک API نیاز دارد. وان ای آی (1ai) همین API را با شکل OpenAI می‌دهد: یک کلید sk-1ai-… برای مدلهای چند سازنده، خرید اعتبار با پرداخت ریالی و سقف مصرف جداگانه برای هر کلید. در این راهنما تنظیمات دقیق Roo Code، انتخاب مدل و خطاهای رایج را می‌بینید.
چرا با 1ai
یک کلید، چند خانواده‌ی مدل
با همان کلید بین Claude، GPT، Gemini، DeepSeek، Qwen و Kimi جابه‌جا شوید؛ فقط شناسهی مدل را در تنظیمات Roo Code عوض کنید.
پرداخت ریالی
اعتبار را با پرداخت ریالی میخرید و هر درخواست به اندازهی توکن‌هایش از همان اعتبار کم میشود؛ کارت ارزی و حساب خارجی لازم نیست.
سقف مصرف برای هر کلید
برای کلیدی که به این ابزار می‌دهید سقف ماهانه، مدلهای مجاز و تاریخ انقضا بگذارید تا یک حلقه‌ی طولانی عامل، کل اعتبار را خرج نکند.
استریم و فراخوانی ابزار
مسیر chat/completions با استریم و tool calling کار می‌کند؛ همان چیزی که یک عامل برنامه‌نویسی برای خواندن فایل، اجرای دستور و ویرایش کد لازم دارد.
در چند قدم
- ۱
Roo Code را نصب کنید
در VS Code بخش Extensions را باز کنید، Roo Code را جست‌وجو و نصب کنید.
- ۲
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Roo Code بسازید، سقف ماهانه بگذارید و کلید را همان لحظه کپی کنید.
- ۳
OpenAI Compatible را انتخاب کنید
در تنظیمات Roo Code (آیکن چرخ‌دنده) گزینه‌ی API Provider را روی OpenAI Compatible بگذارید و Base URL، API Key و Model را وارد کنید.
- ۴
اولین کار را بدهید
در حالت Ask یا Architect یک کار کوچک بخواهید، برنامه را بخوانید و بعد به حالت Code بروید تا تغییرها را با تأیید شما انجام دهد.
مدلهای مناسب Roo Code (با پشتیبانی از ابزار)
همه‌ی مدلهاGPT-6 Luna
سریع و بسیار ارزان؛ مدل پیش‌فرض و در نسخه‌ی رایگان
شروع پاسخ ۲٫۶ ثانیه و سرعت ۶۸ توکن در ثانیه
GPT-6.1 Sol
پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای
شروع پاسخ ۴٫۸ ثانیه و سرعت ۵۶ توکن در ثانیه
Claude Haiku 5.5
سریع‌ترین کلود؛ در نسخه‌ی رایگان
شروع پاسخ ۴٫۶ ثانیه و سرعت ۲۹۸ توکن در ثانیه
نمونه پرامپت‌ها
پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.
شناخت پروژه
Read this repository and give me a short map: main folders, entry points, how to run it locally and how tests are run. Do not change any file yet.
رفع خطا
Running `[دستور، مثلاً npm test]` fails with this error: [متن کامل خطا] Find the cause, explain it in two sentences, apply the smallest fix and run the command again.
نوشتن تست
Write unit tests for [مسیر فایل] that cover edge cases. Use the test framework this project already uses, run the tests and fix only the tests if they fail.
تنظیمات Roo Code برای 1ai چیست؟
در Roo Code روی آیکن چرخ‌دنده بزنید و این مقادیر را وارد کنید:
| تنظیم | مقدار |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://1ai.ir/v1 |
| API Key | کلید sk-1ai-… |
| Model | anthropic/claude-sonnet-5.5 |
در بخش Model Configuration مقدار Max Output Tokens و Context Window را از صفحه‌ی همان مدل بردارید و اگر مدل تصویر میپذیرد، Image Support را روشن کنید. Input Price و Output Price فقط برای تخمین هزینه در خود Roo Code است و می‌توانید خالی بگذارید؛ کسر واقعی را پنل 1ai نشان می‌دهد.
پیش از Roo Code، کلید و آدرس را در ترمینال امتحان کنید:
curl https://1ai.ir/v1/models -H "Authorization: Bearer sk-1ai-..."اگر فهرست مدلها برگشت، کلید و آدرس درست است.
کدام مدل برای Roo Code بهتر است؟
Roo Code فقط با فراخوانی ابزار بومی (native tool calling) کار می‌کند و مدلی که tools را پشتیبانی نکند در آن قابل استفاده نیست. پس یکی از مدلهای دارای ابزار را انتخاب کنید:
| کار | Model ID پیشنهادی |
|---|---|
| برنامه‌ریزی و تغییرهای چندفایلی | anthropic/claude-sonnet-5.5، openai/gpt-6.1-sol |
| اجرای روزمره با هزینهی کم | deepseek/deepseek-v4.1-flash، google/gemini-3.8-flash |
| کارهای طولانی و عامل‌محور | qwen/qwen3.8-max، moonshotai/kimi-k3 |
فهرست زنده‌ی مدلها، قیمت و اندازهی context هر کدام در مدلهای گفتگو آمده است. شناسه را دقیقاً با پیشوند سازنده بنویسید.
خطاهای رایج Roo Code با 1ai و راه‌حل آن‌ها
- 401
invalid_api_keyیا «Invalid API Key»: کلید اشتباه، ناقص کپی‌شده، باطل یا منقضی است. کلید باید باsk-1ai-شروع شود؛ کلمه‌یBearerرا در فیلد API Key ننویسید. - 404
model_not_foundیا «Model Not Found»: شناسه بدون پیشوند سازنده نوشته شده (claude-sonnet-5.5به جایanthropic/claude-sonnet-5.5) یا آن مدل در API فعال نیست. - خطای اتصال یا پاسخ HTML: Base URL باید دقیقاً
https://1ai.ir/v1باشد؛/v1را حذف نکنید و آدرس دیگری مثلapi.1ai.irننویسید. - 403
model_not_allowed: مدل در فهرست «مدلهای مجاز» همین کلید نیست. - 402: اعتبار تمام شده (
insufficient_credits) یا سقف ماهانه‌ی کلید پر شده (key_cap_reached). - 429
rate_limit_exceeded: سقف درخواست یا توکن در دقیقه پر شده؛ به اندازهی سرآیندretry-afterصبر کنید و کارهای هم‌زمان را کم کنید. - خطای فراخوانی ابزار: مدل باید tools را پشتیبانی کند؛ مدل را به یکی از مدلهای دارای ابزار عوض کنید و کار را از نو شروع کنید.
چطور هزینهی Roo Code را کنترل کنیم؟
هر قدم عامل یک درخواست جداست و کل گفتگو در هر درخواست دوباره فرستاده میشود؛ برای همین کارهای طولانی زود گران می‌شوند.
- برای این ابزار کلید جداگانه بسازید و در «تنظیمات پیشرفته» سقف مصرف ماهانه، مدلهای مجاز و تاریخ انقضا بگذارید.
- تأیید خودکار (Auto Approve) را فقط برای کارهای کم‌خطر روشن کنید.
- برای هر موضوع یک کار (Task) تازه باز کنید تا context بی‌دلیل بزرگ نشود.
جزئیات بیشتر در راهنمای کلیدها و کنترل هزینه آمده و اعتبار را در بخش توسعه‌دهندگان میخرید.
سوالات متداول
آیا استفاده از Roo Code با 1ai هزینه دارد؟
خود Roo Code متنباز است. هزینهی مدل به اندازهی توکنهای ورودی و خروجی هر درخواست از اعتبار حساب 1ai کم میشود و اعتبار را با پرداخت ریالی میخرید. اشتراک گفتگوی 1ai شامل مصرف API نیست.
تنظیمات Roo Code با Cline چه فرقی دارد؟
Roo Code از Cline منشعب شده و مسیر اتصال یکی است: API Provider روی OpenAI Compatible، Base URL برابر https://1ai.ir/v1، کلید sk-1ai-… و شناسهی کامل مدل. راهنمای Cline هم در اتصال Cline آمده است.
چرا Roo Code با بعضی مدلها کار نمیکند؟
Roo Code فقط فراخوانی ابزار بومی را میپذیرد. مدلی که tools را پشتیبانی نکند در Roo Code اجرا نمیشود؛ در فهرست مدلهای همین صفحه فقط مدلهای دارای ابزار آمدهاند.
برای اتصال Roo Code به 1ai فیلترشکن لازم است؟
برای ارسال درخواست به https://1ai.ir/v1 فیلترشکن لازم نیست. اگر با فیلترشکن روشن خطای اتصال میگیرید، یک بار بدون آن امتحان کنید.
مطالب مرتبط
استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدلها و مدیریت خطا.
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدلهای مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
مقایسه ChatGPT، Claude و Gemini: کدام مدل برای چه کاری؟
سه خانواده‌ی مطرح مدلهای زبانی، یعنی GPT از OpenAI، Claude از Anthropic و Gemini از گوگل، هر کدام کجا می‌درخشند و چطور برای کار خودتان بهترین را انتخاب کنید.
صفحه‌های مرتبط
همه‌ی امکاناتاتصال Cline
افزونه‌ی Cline را با گزینه‌ی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.
اتصال Kilo Code
در Kilo Code یک Custom provider با گزینه‌ی OpenAI Compatible بسازید، آدرس و کلید 1ai را بدهید و مدلها را خودکار از فهرست 1ai بردارید.
اتصال Continue
Continue را با چند خط config.yaml به API سازگار با OpenAI در 1ai وصل کنید و برای چت، ویرایش، Agent و تکمیل خودکار مدل جداگانه بگذارید.
برنامه‌نویسی با هوش مصنوعی
کد بنویسید، خطا پیدا کنید، SQL و Regex بسازید و با API سازگار با OpenAI مدلها را به ابزارهای خودتان وصل کنید.
اتصال Roo Code به API هوش مصنوعی 1ai؛ راهنمای OpenAI Compatible
افزونه‌ی Roo Code را با گزینه‌ی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.
ساخت کلید API