انتقل إلى المحتوى
كل التوثيق

وكلاء البرمجة

إعداد Goose

يقرأ goose المزوّدين المخصصين من ملفات JSON. احفظ ملف nokeep أدناه، وأعطِ goose مفتاحك، ثم اختر nokeep مزوّدًا في تطبيق سطح المكتب أو في سطر الأوامر.

تم التحقق في 30 أكتوبر 2026

القيم

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

ابدأ بمفتاح الاختبار المجاني: يردّ على كل طلب بسطر ثابت واحد دون أي استدعاء للأدوات، وهذا يثبت صحة العنوان والمفتاح دون أن يكلّفك شيئًا. ثم ألصق مفتاحك من لوحة التحكم. الرصيد يبدأ من 5 دولارات، ولا اشتراك.

الاتصال

  1. احفظ الملف أدناه باسم custom_nokeep.json في المجلد ~/.config/goose/custom_providers/ على macOS وLinux، أو %APPDATA%\Block\goose\config\custom_providers\ على Windows. أنشئ المجلد إن لم يكن موجودًا.
  2. أعطِ goose المفتاح. في الطرفية، اضبط NOKEEP_API_KEY على sk-nokeep-test. في تطبيق goose على سطح المكتب، افتح Settings ثم Models ثم Configure providers، وابحث عن nokeep والصق المفتاح؛ يحتفظ goose به في سلسلة المفاتيح لديك.
  3. ابدأ جلسة عليه: في الطرفية بالأمر أدناه، أو في تطبيق goose على سطح المكتب باختيار 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 على سطح المكتب بعد حفظه. ولجعل 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 المؤرّخ، المثبّت على نسخة واحدة، لمن يريد أن تبقى الجلسة عليه. وglm-5.3-flash-uncensored موجود للمهام القصيرة.

يمكنك أيضًا إضافة المزوّد نفسه يدويًا: من نموذج Add Custom Provider في تطبيق goose على سطح المكتب، أو بالأمر 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
يقرأ لقطات الشاشةنعم، حتى 10 في الطلب الواحدلا، نص فقط
التفكيرمتوقف ما لم يُطلبدائمًا، ولفترة وجيزة
لكل مليون رمز$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. ويُحتسب التفكير ضمن الإخراج.

في goose يبقى reasoning في الملف متوقفًا، فلا يرسل goose أي مستوى جهد أبدًا، ويردّ DeepSeek فورًا. تشغيله يجعل goose يرسل low حتى مع إيقاف التفكير، فيفكّر كل استدعاء ويكلّف أكثر؛ وقيمة medium فيه تُنفَّذ كـ high. للمهمة الصعبة استخدم أداة تستطيع إرسال reasoning_effort: high، أو استدعِ الواجهة كما في التفكير.

تكلفة الجلسة

يرسل الوكيل المحادثة كاملة مع كل استدعاء: التعليمات، والملفات التي قرأها، وكل خطوة سبقت. لنفترض أن الاستدعاء يرسل 60,000 رمز، منها 55,000 هي البداية نفسها في الاستدعاء السابق، ويكتب 1,000. على DeepSeek يكلّف هذا الاستدعاء نحو $0.0046، فتكون 200 استدعاء نحو $0.92. بدون تخزين مؤقت سيكون الاستدعاء نفسه $0.0288.

  • التخزين المؤقت تلقائي ولا حاجة لتفعيله. البداية التي تبلغ نحو 1,000 رمز أو أكثر، والمتكررة خلال دقائق قليلة، تُحتسب بالسعر المخزّن.
  • كل استدعاء يحجز أقصى ما قد يكلّفه، أي موجّهه وأقصى إخراج له، ثم يُسوّى على ما استهلكه فعلًا. عند أقصى إخراج 32,768 رمزًا يكون جزء الإخراج من الحجز نحو $0.0573.
  • تعرض لوحة التحكم الرموز الفعلية لكل استدعاء والرموز المخزّنة والأرصدة المستهلكة. وقد لا يعرف عدّاد التكلفة لدى الوكيل السعر المخزّن، فيُظهر رقمًا أعلى.

كيف تعمل الفوترة.

إذا لم يعمل

ما يعرضه الوكيلالحل
401المفتاح خاطئ أو ملغى. الصقه من جديد دون مسافات أو علامات تنصيص.
402الرصيد المشترى في الحساب نفد. اشحن من 5 دولارات في لوحة التحكم، وفعّل 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. معظم إدخال الوكيل يكون مخزّنًا بعد استدعائه الأول.

هل تعمل إضافات goose مع هذا؟

نعم. تصل الإضافات إلى النموذج كأدوات بصيغة OpenAI، ويستدعيها DeepSeek كأي أداة أخرى.