پرش به محتوا
همه مستندات

عامل‌های کدنویسی

راه‌اندازی Kilo Code

Kilo Code هر API سازگار با OpenAI را به‌عنوان ارائه‌دهندهٔ سفارشی اضافه می‌کند و فهرست مدل‌ها را از آن می‌خواند. nokeep را در تنظیمات اضافه کن، و بعد به مدل‌ها حدهایشان را بده تا Kilo بتواند متن گفتگو را مدیریت کند.

بررسی‌شده در ۷ آبان ۱۴۰۵

مقادیر

آدرس پایه
https://nokeep.ai/v1
کلید API
sk-nokeep-test to test, then your own sk-nokeep-… key
مدل
deepseek-v4.1-flash-uncensored
پنجرهٔ متن
1000000
حداکثر توکن خروجی
32768

با کلید آزمایشی رایگان شروع کن: هر درخواست را با یک خط ثابت و بدون فراخوانی ابزار پاسخ می‌دهد، که آدرس و کلید را بدون خرج کردن چیزی درست نشان می‌دهد. بعد کلید خودت را از کنسول بگذار. اعتبار از ۵ دلار شروع می‌شود، بدون اشتراک.

اتصال

  1. Settings (آیکون چرخ‌دنده) را باز کن و به تب Providers برو.
  2. تا پایین اسکرول کن و روی Custom provider کلیک کن.
  3. Provider ID را nokeep و Display name را nokeep بگذار.
  4. Provider API را روی OpenAI Compatible بگذار.
  5. https://nokeep.ai/v1 را در Base URL و sk-nokeep-test را در API key بچسبان.
  6. زیر Models، deepseek-v4.1-flash-uncensored و glm-5.3-flash-uncensored را از فهرست واکشی‌شده انتخاب کن. اگر فهرست خالی بود، Fetch models را بزن.
  7. روی Submit کلیک کن، مدل را در انتخابگر مدل انتخاب کن و یک پیام بفرست. پاسخی که با «Connected to» شروع شود یعنی درست کار می‌کند.
  8. روی Edit provider کلیک کن و کلید خودت را از کنسول جایگزین کن.

حدهای زیر را تنظیم کن. Kilo این شناسه‌های مدل را نمی‌شناسد، پس بدون آن‌ها پنجرهٔ متن را ۰ می‌گیرد، گفتگو را هرگز فشرده نمی‌کند، و پاسخ‌ها را روی ۳۲,۰۰۰ توکن محدود می‌کند.

حدها، ابزارها و قیمت‌ها

کادر تنظیمات URL، کلید و مدل‌ها را پوشش می‌دهد. حدهای توکن، فراخوانی ابزار، قیمت‌ها و تفکر در kilo.jsonc قرار می‌گیرند: ~/.config/kilo/kilo.jsonc برای همهٔ پروژه‌ها، یا ./kilo.jsonc برای یک پروژه. این کل ارائه‌دهنده است؛ اگر کلید را در NOKEEP_API_KEY گذاشته باشی، به‌جای کادر تنظیمات از آنجا خوانده می‌شود.

kilo.jsonc
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "nokeep/deepseek-v4.1-flash-uncensored",
  "provider": {
    "nokeep": {
      "npm": "@ai-sdk/openai-compatible",
      "env": [
        "NOKEEP_API_KEY"
      ],
      "options": {
        "baseURL": "https://nokeep.ai/v1"
      },
      "models": {
        "deepseek-v4.1-flash-uncensored": {
          "name": "DeepSeek V4.1 Flash Uncensored",
          "tool_call": true,
          "attachment": true,
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "limit": {
            "context": 1000000,
            "output": 32768
          },
          "cost": {
            "input": 0.45,
            "output": 1.75,
            "cache_read": 0.011
          },
          "variants": {
            "think": {
              "reasoningEffort": "high"
            }
          }
        },
        "glm-5.3-flash-uncensored": {
          "name": "GLM 5.3 Flash Uncensored",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 32768
          },
          "cost": {
            "input": 0.2,
            "output": 0.65,
            "cache_read": 0.04
          }
        }
      }
    }
  }
}
  • limit.context زمانی است که Kilo گفتگو را فشرده می‌کند؛ limit.output به‌عنوان سقف هر پاسخ فرستاده می‌شود.
  • cost به‌ازای هر یک میلیون توکن است، با احتساب خواندن‌های کش‌شده، تا نمایش هزینهٔ Kilo با صورت‌حساب یکی باشد.
  • attachment و modalities به تو اجازه می‌دهند اسکرین‌شات را به DeepSeek بدهی. GLM فقط متن می‌خواند.

کدام مدل

deepseek-v4.1-flash-uncensoredglm-5.3-flash-uncensored
پنجرهٔ متن1,000,000 توکن128,000 توکن
طولانی‌ترین پاسخ131,072 توکن32,768 توکن
فراخوانی ابزاربله، برای هر tool_choiceبله، tool_choice از نوع auto یا none
خواندن اسکرین‌شاتبله، تا ۱۰ تا در هر درخواستخیر، فقط متن
تفکرخاموش، مگر درخواست شودهمیشه، کوتاه
در هر ۱ میلیون توکن$0.45 ورودی · $0.011 کش‌شده · $1.75 خروجی$0.20 ورودی · $0.04 کش‌شده · $0.65 خروجی

DeepSeek را برای کار عامل‌ها بگیر. کل یک مخزن کد در متنش جا می‌شود، با هر شکلی ابزار فراخوانی می‌کند، و تاریخچه‌ای که عامل در هر فراخوانی دوباره می‌فرستد با قیمت کش‌شدهٔ $0.011 در میلیون حساب می‌شود. GLM را برای کارهای کوتاه و یک‌باره بگیر که تاریخچهٔ طولانی را دوباره نمی‌فرستند، جایی که قیمت پایین‌تر ورودی تازه و خروجی‌اش برنده است.

هر دو مدل امتناع‌ها (refusals) را از وزن‌هایشان حذف کرده‌اند، پس وقتی کار به یک موضوع حساس نزدیک می‌شود، مثل تست امنیت روی سیستم‌های خودت یا ابزار کنترل محتوا، کد می‌گیری نه امتناع. مقایسهٔ مدل‌ها.

تفکر

DeepSeek فوراً پاسخ می‌دهد، مگر اینکه درخواستی reasoning_effort را مشخص کند؛ این برای حلقهٔ سریع ویرایش و اجرای یک عامل مناسب است. برای برنامه‌ریزی یا یک باگ سخت، از آن بخواه فکر کند: none، low، high و max را می‌پذیرد. مقادیر minimal، medium و xhigh اپ‌های دیگر به نزدیک‌ترین یکی از این‌ها تبدیل می‌شوند؛ هر مقدار دیگری با 400 invalid_reasoning_effort رد می‌شود. تفکر به‌عنوان خروجی حساب می‌شود.

variant با نام think در بالا مقدار reasoning_effort: high را می‌فرستد. برای یک کار سخت به آن برو و برای بقیه برگرد؛ اگر آن را نگذاری، DeepSeek فوراً پاسخ می‌دهد.

هزینهٔ یک نشست

عامل کل گفتگو را در هر فراخوانی می‌فرستد: دستورالعمل‌ها، فایل‌هایی که خوانده، و هر قدمی که تا اینجا برداشته. فرض کن یک فراخوانی ۶۰,۰۰۰ توکن می‌فرستد، که ۵۵,۰۰۰تایش همان شروع فراخوانی قبلی است، و ۱,۰۰۰ توکن تازه می‌نویسد. روی DeepSeek، این فراخوانی حدود $0.0046 هزینه دارد، پس ۲۰۰ فراخوانی حدود $0.92 می‌شود. بدون کش، همین فراخوانی $0.0288 می‌شد.

  • کش خودکار است و چیزی برای روشن کردنش نیست. شروعی به اندازهٔ حدود ۱,۰۰۰ توکن یا بیشتر که در چند دقیقه تکرار شود، با قیمت کش‌شده حساب می‌شود.
  • هر فراخوانی آنچه ممکن است هزینه‌اش شود را نگه می‌دارد، یعنی درخواستش و حداکثر خروجی‌اش، و بعد به آنچه واقعاً مصرف شده تسویه می‌شود. با حداکثر ۳۲,۷۶۸ توکن خروجی، بخش خروجی این نگه‌داشت حدود $0.0573 است.
  • کنسول توکن‌های واقعی هر فراخوانی، توکن‌های کش‌شده و اعتبار را نشان می‌دهد. شمارندهٔ هزینهٔ خود عامل ممکن است قیمت کش‌شده را نداند، و آن‌وقت عدد بالاتر نشان می‌دهد.

نحوهٔ محاسبهٔ هزینه.

اگر کار نکرد

عامل نشان می‌دهدراه‌حل
401کلید اشتباه است یا باطل شده. دوباره بچسبانش، بدون فاصله یا گیومه.
402اعتبار خریداری‌شدهٔ حساب تمام شده. از ۵ دلار در کنسول شارژ کن و Auto top-up را همان‌جا روشن کن تا یک کار طولانی وسط راه نایستد: وقتی موجودی زیر مبلغ انتخابی‌ات بیفتد، روی کارت ذخیره‌شده‌ات اعتبار اضافه می‌شود.
429بیش از ۱۲۰ درخواست در دقیقه روی یک کلید، یا فراتر از سقف روزانه‌ای که روی آن گذاشته‌ای. عامل‌هایی که چند زیرعامل را هم‌زمان اجرا می‌کنند اول به این می‌خورند. ثانیه‌های Retry-After را صبر کن، سقف را در کنسول بالا ببر، یا به هر عامل کلید جدا بده.
400 invalid_reasoning_effortعامل effortی فرستاده که مدل نمی‌پذیرد. DeepSeek این‌ها را می‌پذیرد: none، low، high، max؛ GLM فقط low یا high.
404آدرس اشتباه است یا مسیر دو بار آمده. از https://nokeep.ai/v1 استفاده کن، بدون /chat/completions، و شناسهٔ مدل را با /v1/models بررسی کن.
503مدل مشغول است. چند ثانیه بعد دوباره امتحان کن؛ چیزی کسر نشده.
خط ثابت آزمایشیراه‌اندازی درست است. کلید خودت را بگذار تا پاسخ واقعی بگیری.

هر خطا با راه‌حلش در خطاها آمده است.

پرسش‌ها

کدم ذخیره می‌شود؟

نه. برای هر فراخوانی فقط یک ردیف شمارش نگه می‌داریم: زمان، کلید، مدل، توکن‌ها، اعتبار و وضعیت. هرگز متن درخواست، فایل‌ها یا پاسخ را نگه نمی‌داریم. آنچه نگه می‌داریم.

چرا فراخوانی دوم کمتر از اولی هزینه دارد؟

فراخوانی دوم با همان شروعی آغاز می‌شود که اولی داشت، پس آن شروع از کش با $0.011 در میلیون توکن خوانده می‌شود، نه با $0.45. بیشتر ورودی یک عامل بعد از اولین فراخوانی کش می‌شود.

این در CLI مربوط به Kilo هم کار می‌کند؟

بله. CLI همان kilo.jsonc را می‌خواند، پس بلوک ارائه‌دهندهٔ بالا هر دو را راه می‌اندازد.