اربط DeepSeek Harness بـ CheapTokens: مزوّد مخصص

لاستخدام DeepSeek Harness مع CheapTokens، افتح Settings → Models، وبدّل البطاقة إلى Custom model API، واضبط base URL على https://api.cheaptokens.dev/v1، واختر OpenAI Chat Completions كبروتوكول، والصق مفتاح CheapTokens الخاص بك وأضف معرّف الموديل deepseek-ai/DeepSeek-V4-Flash-0731. اختر ذلك الموديل من القائمة وسيعمل عليه جلستك التالية.

هذه هي الحيلة كاملة. وبقية هذه الصفحة هي النموذج الدقيق، وفحص سريع للتأكد من أن المفتاح يعمل قبل أن تلوم التطبيق، وقائمة قصيرة بما يجب النظر إليه عندما ترفض البوابة الطلب.

الإعدادات أدناه مأخوذة من وثائق Harness بتاريخ 24 أكتوبر 2026. المشروع في معاينة عامة، ويحذّر README الخاص به من أن تغييرات كاسرة للتوافق ستحدث، لذا إذا تغيّر موضع أي تسمية، فثق بالشاشة وبـدليل المزوّد.

ما الذي توصله#

DeepSeek Harness هو وكيل مفتوح المصدر من DeepSeek (رخصة MIT، مبني على معمارية إضافات Cordis). يأتي كتطبيق سطح مكتب لنظام macOS على شرائح Apple silicon وWindows 64-bit، أو كواجهة ويب تشغّلها بـnpx @deepseek-ai/dsh web (يتطلب Node.js). تفتح واجهة الويب على http://127.0.0.1:3080 افتراضيًا.

بشكل افتراضي يطلب مفتاح DeepSeek. لكن شاشة Models نفسها تحتوي على بطاقة لأي شيء غير موجود في كتالوجها، أو وسيط، أو بوابة شركة، أو مزوّد آخر. تلك البطاقة هي ما نستخدمه.

على جانب CheapTokens تحتاج شيئين: مفتاحًا ورصيدًا. إذا لم تنشئ مفتاحًا بعد، فإن أول طلب API لك مع CheapTokens يستغرق دقيقتين، وما هو مفتاح API وكيف تخزنه بأمان يغطي أين تحتفظ به.

افحص المفتاح قبل أن تفتح Harness#

طلب واحد من الطرفية يخبرك ما إذا كان المفتاح والرصيد ومعرّف الموديل سليمة. إذا نجح هذا ولم ينجح Harness، فالمشكلة في النموذج، لا في الحساب.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in five words."}]
  }'

يجب أن تحصل على رد JSON يحتوي على مصفوفة choices وكتلة usage تحصي رموز الإدخال والإخراج. خطأ من نمط Invalid API key يعني المفتاح؛ ورسالة عن الرصيد تعني أن هناك حاجة إلى تعبئة.

املأ نموذج المزوّد المخصص#

افتح Settings → Models وبدّل بطاقة المزوّد إلى Custom model API. املأ الحقول هكذا:

هناك تفصيلان يوقعان الناس في الخطأ. أولًا، base URL هو https://api.cheaptokens.dev/v1، تمامًا كما في curl أعلاه ناقص /chat/completions. ثانيًا، معرّف الموديل هو الكامل مع بادئة deepseek-ai/. اسم قصير مثل deepseek-v4-flash ليس ما يتوقعه API. إذا أردت الخلفية عن base_url وكيفية تبديله، راجع OpenAI-compatible API: what base_url is and how to switch.

هناك أيضًا زر Fetch available models. تقول الوثائق إنه يستعلم GET /models وأنه يمكنك دائمًا كتابة المعرّف يدويًا. كتابته هي المسار الآمن هنا، فافعل ذلك.

اختر الموديل وشغّل مهمة أولى#

افتح قائمة اختيار الموديل واختر موديل CheapTokens. اختيار موديل هناك يجعله الافتراضي للجلسات الجديدة، فلا تحتاج إلى تكرار ذلك.

الآن أعطه شيئًا صغيرًا وقابلًا للفحص. لنفترض أن لديك مشروعًا فيه اختبار فاشل:

Run the tests, find why test_parse_date fails and fix it. Show me the diff.

ما تريد رؤيته: يشغّل الوكيل أمر الاختبار، ويقرأ الملف الفاشل، ويعدّله، ويعيد تشغيل الاختبارات ويعرض فرقًا. إذا فعل ذلك، فالاتصال تم. رصيدك الآن هو ما يدفع ثمن الحلقة.

لماذا يناسب الموديل الرخيص حلقة الوكيل#

الوكيل لا يرسل سؤالًا واحدًا. إنه يرسل المحادثة كاملة، وقوائم الملفات، ومخرجات الأدوات مرة أخرى في كل خطوة، لذا فالجلسة معظمها رموز إدخال. هذا ما يجعل فواتير الوكلاء مفاجئة (why a long chat costs more يشرح الآلية، وHow to estimate the cost of an AI agent يعطي الطريقة).

لنفترض أن جلسة فيها 200 خطوة، كل خطوة ترسل نحو 30,000 رمز من السياق وتحصل على نحو 600 رمز. أي 200 × 30,000 = 6,000,000 رمز إدخال و200 × 600 = 120,000 رمز إخراج. على DeepSeek-V4-Flash تكلف تلك الجلسة $0.102 بأسعار اليوم، وهي أرخص من OpenRouter إجمالًا، مع احتساب الإدخال والإخراج معًا. الجدول أدناه يستخدم نفس عبء العمل لكل موديل نوفّره:

للجلسات الطويلة يمنحك DeepSeek-V4-Flash نافذة سياق 380K، وحتى 32,768 رمزًا في رد واحد، وسعرًا واحدًا في أي ساعة: لا رسوم إضافية في ساعات الذروة. يستخدم نفس الرصيد الذي تستخدمه كل موديلات CheapTokens الأخرى، لذا يمكنك تبديل الموديلات في Harness دون تعبئة الرصيد مرة أخرى. الأسعار الحالية على صفحة الأسعار، وصفحة الموديل فيها المزيد عن خط DeepSeek.

تفضّل إبقاء الجلسة أخف؟ أضف zai-org/GLM-5.3-Flash (سياق 390K، وحتى 8,192 رمز إخراج) أو MiniMaxAI/MiniMax-M2.7 (سياق 180K، وحتى 8,192 رمز إخراج) إلى المزوّد نفسه كمعرّفات موديلات إضافية. يمكن لمزوّد واحد أن يحمل عدة موديلات، وتتيح لك القائمة التنقل بينها.

إذا لم يعمل#

تسرد وثائق Harness المشتبه بهم المعتادين. ها هم مع ما يجب فعله:

• ترفض البوابة كل طلب رغم أن المفتاح وURL صحيحان. شكل الطلب يختلف عما يتوقعه نقطة النهاية. لدى Harness إعدادات توافق لكل موديل، مثل الدور المستخدم لموجّه النظام أو اسم حقل رموز الإخراج. توجد في $DSH_HOME/profiles/<profile>/cordis.patch.yml وتُعاد تحميلها دون إعادة تشغيل. خذ المفاتيح الدقيقة من دليل المزوّد بدلًا من تخمينها.
• قائمة الجهد مفقودة للموديل الذي كتبته. يعرض Harness مستويات الاستدلال فقط للموديلات التي تعلن عنها. الموديل المُدخل يدويًا لا يعلن عن أي منها، لذا تبقى القائمة فارغة. إعلان المستويات جزء من ملف الإعدادات نفسه لكل موديل.
• 401 عند جلب الموديلات. افحص المفتاح، أو تجاوز الزر وأدخل معرّف الموديل بنفسك.
• يتوقف الرد في منتصف الجملة. هذا حد رموز، وليس اتصالًا معطلًا؛ راجع why an AI answer stops mid-sentence.
• 401 أو 403 في السجل من الطلب الأول. أعد فحص curl أعلاه بالمفتاح نفسه. إذا نجح curl، فأعد كتابة المفتاح في حقل Credential؛ مسافة زائدة في النهاية سبب كلاسيكي.

إذا كنت تستخدم بالفعل وكيلًا آخر بالمفتاح نفسه، فإن connecting OpenCode يتبع النمط نفسه، ووثائق CheapTokens تسرد كل نقطة نهاية. أداة أخرى في الدرج نفسه، ورصيد واحد.

قبل أن تغلق التبويب#

• Base URL: https://api.cheaptokens.dev/v1
• Protocol: OpenAI Chat Completions
• Model id: deepseek-ai/DeepSeek-V4-Flash-0731
• Key: من حساب CheapTokens الخاص بك، بعيدًا عن لقطات الشاشة والمستودعات

شغّل مهمة الاختبار الفاشل مرة واحدة وراقب الاستخدام على رصيدك. تلك التشغيلة الواحدة تخبرك بتكلفة جلساتك أنت.