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

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

راه‌اندازی Goose

goose ارائه‌دهندگان سفارشی را از فایل‌های JSON می‌خواند. فایل nokeep زیر را ذخیره کن، کلیدت را به goose بده و در برنامهٔ دسکتاپ یا CLI، nokeep را به‌عنوان ارائه‌دهنده انتخاب کن.

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

مقادیر

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

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

اتصال

  1. فایل زیر را به‌نام custom_nokeep.json در پوشهٔ ~/.config/goose/custom_providers/ در macOS و Linux ذخیره کن، یا در ویندوز در %APPDATA%\Block\goose\config\custom_providers\. اگر پوشه نبود، بسازش.
  2. کلید را به goose بده. در ترمینال، NOKEEP_API_KEY را روی sk-nokeep-test بگذار. در برنامهٔ goose Desktop، Settings و بعد Models و بعد Configure providers را باز کن، nokeep را پیدا کن و کلید را بچسبان؛ goose آن را در keychain نگه می‌دارد.
  3. یک نشست با آن شروع کن: در ترمینال با دستور زیر، یا در goose Desktop با انتخاب nokeep و deepseek-v4.1-flash-uncensored به‌عنوان مدل.
  4. یک پیام بفرست. پاسخی که با «Connected to» شروع شود یعنی راه‌اندازی درست است.
  5. کلید خودت را از کنسول جایگزین کن.
custom_providers/custom_nokeep.json
{
  "name": "custom_nokeep",
  "engine": "openai",
  "display_name": "nokeep",
  "description": "OpenAI-compatible API for uncensored DeepSeek and GLM, paid with prepaid credits",
  "api_key_env": "NOKEEP_API_KEY",
  "base_url": "https://nokeep.ai/v1",
  "model_doc_link": "https://nokeep.ai/docs/models",
  "models": [
    {
      "name": "deepseek-v4.1-flash-uncensored",
      "context_limit": 1000000,
      "input_token_cost": 0.00000045,
      "output_token_cost": 0.00000175,
      "cache_read_token_cost": 0.000000011,
      "currency": "USD",
      "reasoning": false,
      "supports_vision": true
    },
    {
      "name": "deepseek-v4.1-flash-1017-uncensored",
      "context_limit": 1000000,
      "input_token_cost": 0.00000045,
      "output_token_cost": 0.00000175,
      "cache_read_token_cost": 0.000000011,
      "currency": "USD",
      "reasoning": false,
      "supports_vision": true
    },
    {
      "name": "glm-5.3-flash-uncensored",
      "context_limit": 128000,
      "input_token_cost": 0.0000002,
      "output_token_cost": 0.00000065,
      "cache_read_token_cost": 0.00000004,
      "currency": "USD",
      "reasoning": false,
      "supports_vision": false
    }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
Shell
export NOKEEP_API_KEY=sk-nokeep-test
goose session --provider custom_nokeep --model deepseek-v4.1-flash-uncensored

goose فایل را هنگام شروع یک نشست می‌خواند، پس بعد از ذخیرهٔ آن، goose Desktop را دوباره باز کن. برای اینکه nokeep پیش‌فرض شود، GOOSE_PROVIDER را روی custom_nokeep و GOOSE_MODEL را روی شناسهٔ مدل بگذار؛ در config.yaml مربوط به goose یا در متغیرهای محیطی. خود کلید را خارج از config.yaml نگه دار: goose کلیدها را در آنجا نادیده می‌گیرد.

آنچه فایل تنظیم می‌کند

  • base_url در /v1 تمام می‌شود؛ goose خودش /chat/completions را اضافه می‌کند.
  • context_limit پنجرهٔ واقعی هر مدل است، تا goose بداند کی یک نشست طولانی را خلاصه کند.
  • سه هزینه به‌ازای هر توکن و به دلار است، با احتساب خواندن‌های کش‌شده، تا نمایش هزینهٔ goose با صورت‌حساب یکی باشد.
  • supports_vision به تو اجازه می‌دهد اسکرین‌شات به DeepSeek بدهی. GLM فقط متن می‌خواند.
  • فایل نسخهٔ تاریخ‌دار DeepSeek را هم فهرست می‌کند، که به یک build ثابت است، برای وقتی که بخواهی نشستی روی آن بماند. glm-5.3-flash-uncensored برای کارهای کوتاه آنجاست.

می‌توانی همین ارائه‌دهنده را دستی هم اضافه کنی: فرم Add Custom Provider در goose Desktop، یا goose configure و بعد Custom Providers. هر دو فایلی شبیه این می‌نویسند، اما بدون پنجرهٔ متن و قیمت‌ها.

کدام مدل

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 رد می‌شود. تفکر به‌عنوان خروجی حساب می‌شود.

در goose، فایل reasoning را خاموش نگه می‌دارد، پس goose هیچ effortی نمی‌فرستد و DeepSeek فوراً پاسخ می‌دهد. روشن کردنش باعث می‌شود goose حتی با تفکر خاموش low بفرستد، پس هر فراخوانی فکر می‌کند و هزینه‌اش بیشتر می‌شود؛ medium آن به high تبدیل می‌شود. برای یک کار سخت، از ابزاری استفاده کن که بتواند reasoning_effort: high بفرستد، یا API را مطابق تفکر صدا بزن.

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

عامل کل گفتگو را در هر فراخوانی می‌فرستد: دستورالعمل‌ها، فایل‌هایی که خوانده، و هر قدمی که تا اینجا برداشته. فرض کن یک فراخوانی ۶۰٬۰۰۰ توکن می‌فرستد، که ۵۵٬۰۰۰تایش همان شروع فراخوانی قبلی است، و ۱٬۰۰۰ توکن تازه می‌نویسد. روی 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. بیشتر ورودی یک عامل بعد از اولین فراخوانی کش می‌شود.

افزونه‌های goose با این کار می‌کنند؟

بله. افزونه‌ها به‌صورت ابزار در قالب OpenAI به مدل می‌رسند و DeepSeek آن‌ها را مثل هر ابزار دیگری فراخوانی می‌کند.