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

عامل‌های برنامه‌نویسی

راه‌اندازی Zed

پنل عامل Zed هر API سازگار با OpenAI را به‌عنوان ارائه‌دهنده می‌پذیرد. nokeep را از Agent Settings یا settings.json اضافه کن؛ Zed کلید را از NOKEEP_API_KEY یا از keychain سیستمت می‌خواند.

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

مقادیر

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

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

اتصال

  1. Agent Settings را باز کن: از پالت فرمان، agent: open settings را اجرا کن.
  2. در LLM Providers روی Add Provider کلیک کن.
  3. نام آن را nokeep بگذار، https://nokeep.ai/v1 را به‌عنوان نشانی API، deepseek-v4.1-flash-uncensored را به‌عنوان شناسهٔ مدل و 1000000 را به‌عنوان پنجرهٔ زمینه بچسبان.
  4. sk-nokeep-test را به‌عنوان کلید بچسبان. Zed آن را در keychain سیستمت نگه می‌دارد.
  5. پنل عامل را باز کن، DeepSeek V4.1 Flash Uncensored را انتخاب کن و یک پیام بفرست. پاسخی که با “Connected to” شروع شود یعنی کار می‌کند.
  6. کلید را با کلید خودت از کنسول عوض کن.

یا آن را در settings.json تنظیم کن؛ این روش تصویر، فراخوانی موازی ابزارها و کلید کش را هم روشن می‌کند. هرگز کلید را داخل این فایل نگذار: Zed آن را از keychain یا از NOKEEP_API_KEY می‌خواند، یعنی نام ارائه‌دهنده با حروف بزرگ به‌علاوهٔ _API_KEY.

settings.json
{
  "language_models": {
    "openai_compatible": {
      "nokeep": {
        "api_url": "https://nokeep.ai/v1",
        "available_models": [
          {
            "name": "deepseek-v4.1-flash-uncensored",
            "display_name": "DeepSeek V4.1 Flash Uncensored",
            "max_tokens": 1000000,
            "max_output_tokens": 32768,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": true,
              "prompt_cache_key": true
            }
          },
          {
            "name": "glm-5.3-flash-uncensored",
            "display_name": "GLM 5.3 Flash Uncensored",
            "max_tokens": 128000,
            "max_output_tokens": 32768,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          }
        ]
      }
    }
  }
}

تنظیماتی که ارزش دانستن دارند

  • max_tokens در تنظیمات Zed پنجرهٔ زمینه است، نه سقف پاسخ. max_output_tokens سقف هر پاسخ است.
  • prompt_cache_key باعث می‌شود فراخوانی‌های هر گفتگو به سروری بروند که ابتدای همان گفتگو را کش کرده است. DeepSeek آن را می‌پذیرد؛ GLM آن را نادیده می‌گیرد.
  • images اجازه می‌دهد به گفتگوی 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 برای کارهای کوتاه و یک‌باره استفاده کن که تاریخچهٔ طولانی را دوباره نمی‌فرستند؛ آنجا قیمت پایین‌تر ورودی تازه و خروجی‌اش به صرفه‌تر است.

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

تفکر

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

در Zed، به ورودی DeepSeek عبارت "reasoning_effort": "high" را اضافه کن. Zed آن‌گاه یک کلید تفکر در پنل عامل نشان می‌دهد و وقتی روشن است، آن مقدار را می‌فرستد. از low، high یا max استفاده کن؛ minimal، medium و xhigh هم کار می‌کنند و روی نزدیک‌ترین‌شان اجرا می‌شوند.

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

یک عامل در هر فراخوانی کل گفتگو را می‌فرستد: دستورالعمل‌ها، فایل‌هایی که خوانده، و هر مرحله تا اینجا. فرض کن یک فراخوانی 60,000 توکن می‌فرستد که 55,000 تای آن همان ابتدای فراخوانی قبلی است، و 1,000 توکن می‌نویسد. روی DeepSeek این فراخوانی حدود $0.0046 هزینه دارد، پس 200 فراخوانی حدود $0.92 می‌شود. بدون کش، همین فراخوانی $0.0288 می‌شد.

  • کش خودکار است و چیزی برای روشن کردنش نیست. شروعی به اندازهٔ حدود 1,000 توکن یا بیشتر که در چند دقیقه تکرار شود، با قیمت کش‌شده حساب می‌شود.
  • هر فراخوانی بیشترین هزینهٔ ممکنش را، یعنی پرامپت و سقف خروجی‌اش را، رزرو می‌کند و بعد روی مصرف واقعی تسویه می‌شود. با سقف خروجی 32,768 توکن، بخش خروجیِ این رزرو حدود $0.0573 است.
  • کنسول توکن‌های واقعی، توکن‌های کش‌شده و اعتبار هر فراخوانی را نشان می‌دهد. شمارندهٔ هزینهٔ خود عامل ممکن است قیمت کش را نداند و آن‌وقت عدد را بالاتر نشان بدهد.

نحوهٔ محاسبهٔ صورتحساب.

اگر کار نکرد

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

همهٔ خطاها با راه‌حلشان در خطاها فهرست شده‌اند.

پرسش‌ها

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

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

چرا فراخوانی دوم از اولی ارزان‌تر است؟

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