راهنمای اتصال به API

اتصال Kilo Code به API هوش مصنوعی 1ai؛ راهنمای Custom provider

Q: آیا استفاده از Kilo Code با 1ai هزینه دارد؟

هزینهی مدل به اندازهی توکنهای ورودی و خروجی هر درخواست از اعتبار حساب 1ai کم میشود و اعتبار را با پرداخت ریالی میخرید. اشتراک گفتگوی 1ai شامل مصرف API نیست.

Q: در Provider API کدام گزینه را بزنم؟

گزینهی OpenAI Compatible را انتخاب کنید و Base URL را https://1ai.ir/v1 بگذارید. با همین تنظیم همهی مدلهای گفتگوی API، از Claude تا GPT و Gemini، در دسترساند.

Q: تنظیمات Kilo Code با Cline چه فرقی دارد؟

در Cline گزینهی OpenAI Compatible در خود فهرست API Provider است؛ در Kilo Code آن را بهصورت Custom provider میسازید و مدلها خودکار از 1ai خوانده میشوند. آدرس، کلید و شناسهی مدلها یکی است. راهنمای Cline در اتصال Cline آمده است.

Q: برای اتصال Kilo Code به 1ai فیلترشکن لازم است؟

برای ارسال درخواست به https://1ai.ir/v1 فیلترشکن لازم نیست. اگر با فیلترشکن روشن خطای اتصال میگیرید، یک بار بدون آن امتحان کنید.

Kilo Code یک دستیار عامل‌محور برنامه‌نویسی برای VS Code و ترمینال است که مثل Cline پروژه را می‌خواند، فایل ویرایش می‌کند و دستور اجرا می‌کند. با یک Custom provider می‌توانید آن را به وان ای آی (1ai) وصل کنید: یک کلید sk-1ai-… برای مدل‌های چند سازنده، خرید اعتبار با پرداخت ریالی و سقف مصرف جداگانه برای هر کلید. Kilo Code فهرست مدل‌ها را خودش از /v1/models می‌خواند، پس لازم نیست شناسه‌ها را دستی بنویسید.

ساخت کلید API مدل‌های مناسب Kilo Code (با پشتیبانی از ابزار)

چرا با 1ai

یک کلید، چند خانواده‌ی مدل

با همان کلید بین Claude، GPT، Gemini، DeepSeek، Qwen و Kimi جابه‌جا شوید؛ فقط شناسه‌ی مدل را در تنظیمات Kilo Code عوض کنید.

پرداخت ریالی

اعتبار را با پرداخت ریالی می‌خرید و هر درخواست به اندازه‌ی توکن‌هایش از همان اعتبار کم می‌شود؛ کارت ارزی و حساب خارجی لازم نیست.

سقف مصرف برای هر کلید

برای کلیدی که به این ابزار می‌دهید سقف ماهانه، مدل‌های مجاز و تاریخ انقضا بگذارید تا یک حلقه‌ی طولانی عامل، کل اعتبار را خرج نکند.

استریم و فراخوانی ابزار

مسیر chat/completions با استریم و tool calling کار می‌کند؛ همان چیزی که یک عامل برنامه‌نویسی برای خواندن فایل، اجرای دستور و ویرایش کد لازم دارد.

در چند قدم

۱
Kilo Code را نصب کنید
در VS Code بخش Extensions را باز کنید و Kilo Code را نصب کنید.
۲
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Kilo Code بسازید، سقف ماهانه بگذارید و کلید را همان لحظه کپی کنید.
۳
Custom provider بسازید
در Settings (آیکن چرخ‌دنده) به زبانه‌ی Providers بروید، پایین صفحه Custom provider را بزنید و Provider API را روی OpenAI Compatible بگذارید.
۴
مدل‌ها را انتخاب کنید
Base URL و API key را وارد کنید تا مدل‌ها خودکار بیایند، مدل‌های دلخواه را اضافه کنید، Submit بزنید و از انتخابگر مدل یکی را بردارید.

مدل‌های مناسب Kilo Code (با پشتیبانی از ابزار)

همه‌ی مدل‌ها

GPT-6 Luna

اوپن‌ای‌آی

گفتگو

سریع و بسیار ارزان؛ مدل پیش‌فرض و در نسخه‌ی رایگان

شروع پاسخ ۲٫۶ ثانیه و سرعت ۶۸ توکن در ثانیه

در نسخه‌ی رایگان

رایگانAPI

GPT-6.1 Sol

اوپن‌ای‌آی

گفتگو

پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای

شروع پاسخ ۴٫۸ ثانیه و سرعت ۵۶ توکن در ثانیه

با اشتراک

API

Claude Sonnet 5.5

آنتروپیک

گفتگو

نویسندگی روان و برنامه‌نویسی دقیق

با اشتراک

API

Gemini 3.8 Flash

گوگل

گفتگو

سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند

با اشتراک

API

Claude Haiku 5.5

آنتروپیک

گفتگو

سریع‌ترین کلود؛ در نسخه‌ی رایگان

شروع پاسخ ۴٫۶ ثانیه و سرعت ۲۹۸ توکن در ثانیه

در نسخه‌ی رایگان

رایگانAPI

Gemini 3.5 Flash Lite

گوگل

گفتگو

سبک و ارزان؛ در نسخه‌ی رایگان

در نسخه‌ی رایگان

رایگانAPI

نمونه پرامپت‌ها

پرامپت را کپی کنید، در 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.

تنظیمات Kilo Code برای 1ai چیست؟

در Kilo Code به Settings \leftarrow Providers بروید و پایین صفحه Custom provider را بزنید. پنجره را این‌طور پر کنید: تنظیم مقدار Provider ID oneai Display name 1ai Provider API OpenAI Compatible Base URL https://1ai.ir/v1 API key کلید sk-1ai-\dots Models از فهرست خودکار، مثلاً anthropic/claude-sonnet-5.5 با وارد کردن Base URL و کلید، Kilo Code فهرست مدل‌ها را از https://1ai.ir/v1/models می‌خواند؛ اگر فهرست نیامد، Fetch models را بزنید یا شناسه را دستی وارد کنید. سرآیند (Headers) لازم نیست. بعد از Submit، مدل‌های 1ai در انتخابگر مدل دیده می‌شوند. تنظیمات بیشتر مثل سقف توکن در فایل kilo.jsonc است. پیش از Kilo Code، کلید و آدرس را در ترمینال امتحان کنید: bash curl https://1ai.ir/v1/models -H "Authorization: Bearer sk-1ai-..." اگر فهرست مدل‌ها برگشت، کلید و آدرس درست است.

تنظیم	مقدار
Provider ID	`oneai`
Display name	`1ai`
Provider API	`OpenAI Compatible`
Base URL	`https://1ai.ir/v1`
API key	کلید `sk-1ai-…`
Models	از فهرست خودکار، مثلاً `anthropic/claude-sonnet-5.5`

کدام مدل برای Kilo Code بهتر است؟

Kilo Code برای خواندن فایل، اجرای دستور و ویرایش کد به فراخوانی ابزار تکیه می‌کند، پس مدلی را بردارید که 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 هر کدام در مدل‌های گفتگو آمده است. شناسه را دقیقاً با پیشوند سازنده بنویسید.

کار	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`

خطاهای رایج Kilo 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 را پشتیبانی کند؛ مدل را به یکی از مدل‌های دارای ابزار عوض کنید و کار را از نو شروع کنید. فهرست مدل‌ها خالی است : Base URL یا کلید را درست کنید و دوباره Fetch models را بزنید.

چطور هزینه‌ی Kilo Code را کنترل کنیم؟

هر قدم عامل یک درخواست جداست و کل گفتگو در هر درخواست دوباره فرستاده می‌شود؛ برای همین کارهای طولانی زود گران می‌شوند. برای این ابزار کلید جداگانه بسازید و در «تنظیمات پیشرفته» سقف مصرف ماهانه، مدل‌های مجاز و تاریخ انقضا بگذارید. تأیید خودکار (Auto Approve) را فقط برای کارهای کم‌خطر روشن کنید. برای هر موضوع یک کار (Task) تازه باز کنید تا context بی‌دلیل بزرگ نشود. جزئیات بیشتر در راهنمای کلیدها و کنترل هزینه آمده و اعتبار را در بخش توسعه‌دهندگان می‌خرید.

سوالات متداول

آیا استفاده از Kilo Code با 1ai هزینه دارد؟

هزینه‌ی مدل به اندازه‌ی توکن‌های ورودی و خروجی هر درخواست از اعتبار حساب 1ai کم می‌شود و اعتبار را با پرداخت ریالی می‌خرید. اشتراک گفتگوی 1ai شامل مصرف API نیست.

در Provider API کدام گزینه را بزنم؟

گزینه‌ی OpenAI Compatible را انتخاب کنید و Base URL را https://1ai.ir/v1 بگذارید. با همین تنظیم همه‌ی مدل‌های گفتگوی API، از Claude تا GPT و Gemini، در دسترس‌اند.

تنظیمات Kilo Code با Cline چه فرقی دارد؟

در Cline گزینه‌ی OpenAI Compatible در خود فهرست API Provider است؛ در Kilo Code آن را به‌صورت Custom provider می‌سازید و مدل‌ها خودکار از 1ai خوانده می‌شوند. آدرس، کلید و شناسه‌ی مدل‌ها یکی است. راهنمای Cline در اتصال Cline آمده است.

برای اتصال Kilo 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 از گوگل، هر کدام کجا می‌درخشند و چطور برای کار خودتان بهترین را انتخاب کنید.

۲۰ مهر ۱۴۰۵۴ دقیقه مطالعه

همه‌ی امکانات