Kilo Code را روی هر مدل کاتالوگ از طریق OpenAI Compatible اجرا کنید.

Updated 2026-07-30

Kilo Code یک flow provider سفارشی ساخته‌شده برای gateway ها عرضه می‌کند: OpenAI Compatible را به‌عنوان Provider API انتخاب کنید، Base URL را روی https://api.apisrouter.com/v1 تنظیم کنید، یک کلید بچسبانید، و Kilo فهرست مدل را از /v1/models به‌طور خودکار fetch می‌کند. id های Claude، Kimi، و رده-Codex به backend های قابل‌تعویض برای agent تبدیل می‌شوند.

پاسخ سریع: یک ورودی provider سفارشی.

تنظیمات Kilo Code را از طریق آیکون چرخ‌دنده باز کنید، به تب Providers بروید، و گزینه custom provider را انتخاب کنید. یک Provider ID و نام نمایشی به آن بدهید، Provider API را روی OpenAI Compatible تنظیم کنید، Base URL را روی https://api.apisrouter.com/v1، و کلید خود را بچسبانید. وقتی Base URL و کلید معتبر باشند، Kilo فهرست /v1/models endpoint را پرس‌وجو می‌کند و یک انتخاب‌گر قابل‌جست‌وجو از هر id در دسترس ارائه می‌دهد، پس claude-sonnet-4-6 یا kimi-k2.7-code را از یک فهرست انتخاب می‌کنید به‌جای تایپ کورکورانه آن. مدل‌ها همچنین می‌توانند دستی اضافه شوند، و header های HTTP سفارشی به‌عنوان جفت‌های key-value پشتیبانی می‌شوند اگر به آن‌ها نیاز داشته باشید. ذخیره کنید، و وظیفه بعدی agent از طریق gateway مسیردهی می‌شود.

Provider ID:    apisrouter
Display name:   APIsRouter
Provider API:   OpenAI Compatible
Base URL:       https://api.apisrouter.com/v1
API key:        sk-YOUR-APISROUTER-KEY
Models:         pick from the auto-fetched list
                (e.g. claude-sonnet-4-6, kimi-k2.7-code)

چطور Kilo Code از provider استفاده می‌کند.

Kilo Code (حدود ۲۶ هزار ستاره در GitHub) یک agent کدنویسی AI متن‌باز برای VS Code است: برنامه‌ریزی می‌کند، فایل‌ها را ویرایش می‌کند، دستورات را اجرا می‌کند، و روی شکست‌ها با gate های تأیید تکرار می‌کند، در دودمان Roo و Cline. آن حلقه یک شکل ترافیک خاص دارد: context بلند وارد می‌شود، فراخوانی‌های tool و diff خارج می‌شود، نوبت‌های زیاد به ازای هر وظیفه، که مدل پشتیبان را هم اهرم کیفیت هم محرک هزینه می‌کند. provider سازگار با OpenAI آن حلقه را به‌عنوان chat completions استاندارد به Base URL شما می‌فرستد، با id مدل به‌عنوان رشته ساده. فرمت wire به vendor ها اهمیتی نمی‌دهد، که همان چیزی است که خرید واقعی مدل را ممکن می‌کند: claude-sonnet-4-6، kimi-k2.7-code، و gpt-5.6-sol ورودی‌های قابل‌تعویض پشت یک provider هستند، به‌جای سه حساب vendor با سه راه‌اندازی صورت‌حساب. برای تنظیم هر-مدل، محدودیت‌های token، رفتار tool-calling، و variant ها در فایل config برابر kilo.jsonc زندگی می‌کنند، که می‌توانید مستقیم ویرایش کنید وقتی یک مدل تنظیماتی می‌خواهد که UI افشا نمی‌کند. محدودیت‌های اعلام‌شده را از مستندات مدل تنظیم کنید، نه از خوش‌بینی: agent به‌شدت context را پر می‌کند، و یک پنجره اغراق‌شده دقیقاً روی بزرگ‌ترین وظایف شکست می‌خورد.

انتخاب مدل‌های کدنویسی برای حلقه Kilo.

حالت‌های Kilo اجازه می‌دهند انواع مختلف کار پیکربندی مختلفی حمل کنند، و روش صادقانه بهره‌برداری از آن تجربی است: همان کلاس وظیفه را روی دو id به مدت یک هفته اجرا کنید، سپس هزینه هر-مدل را در کنسول gateway کنار اینکه چند بار مجبور به دخالت شدید بخوانید. حلقه‌های agent token-فشرده‌ترین راه استفاده از یک مدل هستند، پس تفاوت قابل‌اندازه‌گیری است، نه حس درونی.

  • claude-sonnet-4-6 پیش‌فرض قابل‌اتکا است: tool calling قوی، diff های تمیز، و بازیابی خوب وقتی یک دستور در میان وظیفه شکست می‌خورد.
  • kimi-k2.7-code انتخاب حجمی برای session های agentic بلند است، code-tuned و قیمت‌گذاری‌شده برای حلقه بسیار-نوبتی که Kilo واقعاً اجرا می‌کند.
  • gpt-5.6-sol برای ویرایش‌های سریع محدود و اجراهای test-fixing مناسب است جایی که latency هر-نوبت session را شکل می‌دهد.
  • claude-opus-4-7 نرخ خود را روی وظایف سخت کسب می‌کند: refactor های میان-فایل، کار معماری، دیباگی که تصویر کامل را در context نیاز دارد.
  • gpt-5.5 عام‌گرای frontier است برای A/B در برابر Claude روی repository خود شما به‌جای جدول‌های benchmark.

پرداخت بر اساس مصرف · پایین‌تر از قیمت رسمی

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

مدلقیمت رسمیقیمت ما
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Opus 4.7$5.00 / $25.00 per M$4.00 / $20.00 per M
Kimi K2.7 Code$0.95 / $4.00 per M$1.00 / $4.00 per M
GPT-5.6 Sol$5.00 / $30.00 per M$4.00 / $24.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M

حالت‌های شکست مختص Kilo Code.

در ترتیب استاندارد دیباگ کنید: فهرست مدل‌ها را curl کنید، یک completion را با id دقیق curl کنید، و فقط بعد از آن تنظیمات Kilo را تنظیم کنید. دو دستور مشکلات gateway را تمیز از پیکربندی ادیتور جدا می‌کند.

  • انتخاب‌گر مدل خالی می‌آید: Base URL یا کلید اشتباه است، چون انتخاب‌گر از یک فراخوانی زنده /v1/models پر می‌شود. فهرست را با همان مقادیر curl کنید تا تأیید شود.
  • ۴۰۴ روی هر درخواست: Base URL پسوند /v1 خود را گم کرده، یا شما یک مسیر کامل /chat/completions را جایی چسبانده‌اید که یک base تعلق دارد. Kilo URL های endpoint کامل را می‌پذیرد، اما فقط اگر به مسیر درست chat-completions اشاره کنند.
  • رفتار بریده‌شده یا فراموشکار عمیق در یک وظیفه: محدودیت‌های context اعلام‌شده در kilo.jsonc از آنچه مدل واقعاً پشتیبانی می‌کند فراتر می‌رود. از مقادیر مستند استفاده کنید.
  • فراخوانی‌های tool روایت‌شده به‌جای اجراشده: id انتخاب‌شده در function calling ضعیف است. وظیفه را روی claude-sonnet-4-6 دوباره اجرا کنید تا انتخاب مدل را از پیکربندی جدا کنید قبل از لمس تنظیمات.
  • نکته مختص-Azure از مستندات: deployment های Azure GPT-5 فیلد max_tokens ای که provider های سفارشی سازگار با OpenAI می‌فرستند را رد می‌کنند، پس Azure باید از provider native برابر azure در Kilo استفاده کند. برای یک gateway نامرتبط است، اما یک خطای گیج‌کننده را توضیح می‌دهد اگر هر دو را تست کنید.

چه کسانی Kilo Code را از طریق یک gateway مسیردهی می‌کنند.

  • توسعه‌دهندگانی که Claude را می‌خواهند agent را بدون یک رابطه صورت‌حساب جدای Anthropic هدایت کند، روی یک موجودی پیش‌پرداخت با شروع رایگان و بدون کارت.
  • خریداران مدل که از انتخاب‌گر auto-fetch شده برای آزمایش id های کدنویسی روی وظایف واقعی در repository واقعی خود استفاده می‌کنند.
  • کاربران سنگین که یک مدل frontier را برای کار سطح-برنامه‌ریزی با یک مدل حجمی برای session های اجرای بلند جفت می‌کنند.
  • تیم‌هایی که هزینه agent را به ازای هر توسعه‌دهنده با usage هر-کلید متر می‌کنند به‌جای reverse-engineering یک صورت‌حساب مشترک vendor.
  • افرادی که از قبل ابزارهای دیگر را از طریق یک gateway مسیردهی می‌کنند و می‌خواهند agent VS Code روی همان کلید و usage log باشد.

endpoint را تأیید کنید و اولین وظیفه را اجرا کنید.

نیمه gateway را با curl قبل از پیکربندی ادیتور اثبات کنید: مدل‌ها را فهرست کنید، سپس یک completion را با id ای که قصد انتخابش را دارید بفرستید. وقتی هر دو موفق شوند، همه‌چیز باقی‌مانده در فرم provider است. سپس به Kilo یک وظیفه واقعی کوچک با یک هدف واضح بدهید و نوبت‌های اول را تماشا کنید. فراخوانی‌های tool تمیز و ویرایش‌های معقول یعنی id با حلقه تناسب دارد؛ خطاهای سخت به سه فیلد نگاشت می‌شوند. وقتی وظایف جاری شوند، کنسول APIsRouter مدل، token، و هزینه هر-درخواست را نشان می‌دهد، که یک هفته استفاده از agent را به یک عدد ملموس به ازای هر مدل تبدیل می‌کند.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kimi-k2.7-code",
       "messages":[{"role":"user","content":"ping"}]}'

پرسش‌های پرتکرار

چطور یک provider سازگار با OpenAI به Kilo Code اضافه کنم؟

آیکون تنظیمات ← تب Providers ← custom provider. Provider API را روی OpenAI Compatible تنظیم کنید، Base URL را روی https://api.apisrouter.com/v1، و کلید خود را بچسبانید. سپس Kilo فهرست مدل را از /v1/models به‌طور خودکار fetch می‌کند و شما id ها را از یک فهرست قابل‌جست‌وجو انتخاب می‌کنید.

آیا Kilo Code می‌تواند مدل‌های Claude را از طریق این provider اجرا کند؟

بله. provider id مدل را به‌عنوان رشته ساده روی chat completions استاندارد فوروارد می‌کند، پس claude-sonnet-4-6 و claude-opus-4-7 همانطور که id های GPT کار می‌کنند کار می‌کنند، روی یک کلید، و عوض‌کردن vendor یک انتخاب در انتخاب‌گر است.

چرا فهرست مدل بعد از اضافه‌کردن provider خالی است؟

auto-fetch از یک فراخوانی زنده /v1/models پر می‌شود، پس یک فهرست خالی یعنی Base URL یا کلید اشتباه است. فهرست را با همان مقادیر curl کنید؛ اگر آن کار کرد، دوباره چک کنید واقعاً چه چیزی در فرم provider ذخیره کرده‌اید. مدل‌ها همچنین می‌توانند دستی اضافه شوند.

کجا context window و محدودیت‌های token را برای یک مدل سفارشی تنظیم کنم؟

در kilo.jsonc، فایل config کیلو، که محدودیت‌های token هر-مدل، تنظیمات tool-calling، و variant های فراتر از آنچه فرم provider افشا می‌کند را حمل می‌کند. از مقادیر مستند مدل استفاده کنید؛ محدودیت‌های اغراق‌شده روی بزرگ‌ترین وظایف شکست می‌خورند.

آیا API key باید در فرم برود؟

فیلد کلید مسیر عادی است، اما اختیاری است اگر احراز هویت را از طریق header های سفارشی مدیریت می‌کنید، که فرم provider آن‌ها را به‌عنوان جفت‌های key-value پشتیبانی می‌کند. برای یک راه‌اندازی استاندارد gateway، فیلد کلید انتخاب درست است.

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

نمای usage هر-کلید را در کنسول APIsRouter بخوانید: token و هزینه به ازای هر درخواست و هر مدل. وظایف agent هرکدام ده‌ها درخواست‌اند، پس log تنها اندازه‌گیری صادقانه چیزی است که الگوی usage شما هزینه دارد.