اربط Cherry Studio بـ CheapTokens: مزوّد مخصص وBase URL

لاستخدام CheapTokens في Cherry Studio، أضف مزوّدًا مخصصًا (Settings → Model Provider → Add Provider)، وضع https://api.cheaptokens.dev/v1/ في حقل OpenAI Base URL، والصق مفتاح API الخاص بك وأضف معرّف النموذج deepseek-ai/DeepSeek-V4-Flash-0731 يدويًا. ثم تحقّق من المفتاح عبر Model Check وأرسل تحية. هذا كل ما في الأمر؛ التفصيل الوحيد الذي قد يوقعك في الخطأ هو الشرطة المائلة في نهاية الرابط.

أنت تفتح تطبيق محادثة سطح مكتب لأنك تريد نافذة واحدة لعدة نماذج ورصيدًا واحدًا خلفها، لا تبويب متصفح لكل خدمة. صُمّم Cherry Studio لهذا الغرض: فهو محطة عمل ذكاء اصطناعي مفتوحة المصدر لنظامي Windows وmacOS وLinux (إصدار Community Edition بترخيص AGPL-3.0) مع المحادثة والوكلاء وقواعد المعرفة، ويقبل أي خدمة متوافقة مع OpenAI كمزوّد مخصص. يتحدث CheapTokens صيغة OpenAI Chat Completions، لذا فهو متوافق. تتبع الخطوات أدناه صفحة وثائق Cherry Studio حول المزوّدين المخصصين، التي تم التحقق منها في 7 نوفمبر 2026؛ التطبيق نفسه يتغير، لذا إن انتقل أحد العناصر فابحث عن الكلمة نفسها في الجوار.

ما تحتاجه قبل فتح التطبيق#

ثلاثة أشياء، كلها قصيرة:

• عنوان Base URL: https://api.cheaptokens.dev/v1/ (مع الشرطة المائلة في النهاية — السبب في القسم التالي)؛
• مفتاح API من حسابك في CheapTokens، محفوظ في مكان يمكنك النسخ منه، لا ملصقًا في ملاحظة مشتركة؛
• معرّف النموذج الكامل. الاسم المختصر من قائمة الأسعار لا يقبله API؛ استخدم معرّف البوابة، مثل deepseek-ai/DeepSeek-V4-Flash-0731. المعرّفات الأخرى موجودة في دليل list-models وفي وثائق CheapTokens.

أضف المزوّد المخصص#

افتح Settings (أيقونة الترس)، ثم Model Provider. في أسفل قائمة المزوّدين تجد + Add Provider. انقر عليه فيظهر مربّع حوار Add Custom Provider.

املأه هكذا:

يعرض Cherry Studio حقلي نقطة النهاية 'OpenAI' و'Anthropic' افتراضيًا. املأ فقط البروتوكول الذي تستخدمه فعليًا؛ في المحادثة العادية يكون بروتوكول OpenAI، ويمكن أن يبقى حقل Anthropic فارغًا. تحت كل حقل Base URL يعرض التطبيق معاينة لمسار الطلب النهائي. اقرأها. فهي أسرع طريقة لاكتشاف عنوان خاطئ قبل إرسال أي شيء.

انقر Add للحفظ.

لماذا تهمّ الشرطة المائلة في النهاية#

يبني Cherry Studio رابط الطلب من Base URL وفق ثلاث قواعد في وثائقه (تم التحقق منها في 7 نوفمبر 2026):

• عنوان جذري مثل https://example.com يُلحق به /v1/chat/completions؛
• عنوان ينتهي بـ / يُلحق به chat/completions فقط؛
• عنوان ينتهي بـ # يُستخدم كما هو مكتوب، دون إضافة أي شيء.

يقع CheapTokens تحت /v1، لذا فإن https://api.cheaptokens.dev/v1/ هو الشكل الذي يتحول إلى https://api.cheaptokens.dev/v1/chat/completions — المسار الذي يتوقعه API. يجب أن تقرأ المعاينة تحت الحقل ذلك بالضبط. إذا رأيت /v1/v1/ أو لم تجد /v1 إطلاقًا، فأصلح الحقل قبل المتابعة.

المفتاح والنموذج وModel Check#

بالعودة إلى صفحة المزوّد هناك خمس خطوات صغيرة. نفّذها بهذا الترتيب:

ملاحظة حول الخطوة 5. تحتوي الصفحة أيضًا على زر Sync models الذي يجلب قائمة نماذج من الخدمة. الطريق الموثوق هو إضافة المعرّف بنفسك عبر +: اكتب deepseek-ai/DeepSeek-V4-Flash-0731 بالضبط، مع جزء deepseek-ai/. النماذج التي يمكنك إضافتها:

Model Check هو الزر المجاور لحقل المفتاح؛ وفقًا لوثائق Cherry Studio، يتحقق من صلاحية المفتاح. إذا اشتكى، فانتقل إلى قسم الأخطاء أدناه: السبب عادةً أحد ثلاثة حقول.

أرسل الرسالة الأولى#

افتح محادثة جديدة، واختر مزوّد CheapTokens والنموذج الذي أضفته في محدّد النموذج أعلى الشاشة، واكتب شيئًا قصيرًا، مثل 'اشرح ما هو الـ token في جملتين.' ردّ من النموذج يعني أن السلسلة كاملة تعمل: المفتاح والعنوان ومعرّف النموذج.

أتريد رؤية طلب دون التطبيق؟ إليك استدعاء Chat Completions عاديًا:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

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": "Explain what a token is in two sentences."}]}'

الردّ JSON يحتوي النص في choices[0].message.content وعدد الـ tokens في usage.

أي نموذج تضع في محادثة سطح المكتب#

نافذة المحادثة مهمة مختلفة عن حلقة الوكيل: تسأل وتقرأ وتسأل مجددًا. حينها يهمّ أمران: كم يمكن أن تطول الإجابات وكم تتسع المحادثة.

• DeepSeek-V4-Flash — الخيار الافتراضي للمحادثة العامة والمستندات الطويلة: حتى 32,768 token إخراج لكل إجابة، وسياق 380K، وسعر واحد في أي ساعة. إجمالًا، مع احتساب الإدخال والإخراج معًا، هو أرخص من OpenRouter.
• GLM-5.3-Flash — محادثة يومية بأكبر نافذة بين الثلاثة (390K)، وأرخص من OpenRouter في الإدخال والإخراج معًا.
• MiniMax-M2.7 — محادثة ومهام بأسلوب الوكيل بسياق 180K، وأرخص من OpenRouter على الجانبين.

الثلاثة جميعًا خلف رصيد واحد، لذا يمكنك إضافة المعرّفات الثلاثة إلى المزوّد نفسه والتبديل في محدّد النموذج دون لمس المفتاح.

كم تكلّف جلسة محادثة#

إليك صورة تقريبية. لنفترض أن لديك محادثة من 20 رسالة. كل رسالة تعيد إرسال السجل السابق، لذا يبلغ متوسط الطلب نحو 6,000 token إدخال و500 token إخراج (وهذا سبب مشروح في لماذا تكلّف المحادثة الطويلة أكثر). يكلف طلب واحد على DeepSeek-V4-Flash $0.00014. عشرون طلبًا منها في الحاسبة أدناه؛ حرّك المنزلقات لتطابق محادثاتك.

يشغّل الجدول أدناه الجلسة نفسها على جميع النماذج، مع عمود OpenRouter للمقارنة:

للاطلاع على الأسعار الحالية لكل 1M token راجع أسعار CheapTokens.

إذا لم يعمل#

معظم المشكلات تأتي من الحقول الثلاثة نفسها: المفتاح والرابط ومعرّف النموذج. طابق ما تراه مع السبب:

لشرح أطول لهذه الأخطاء، راجع API 401 أو 404: مفتاح أو Base URL أو معرّف نموذج خاطئ. وإن كنت تفضّل محادثة في المتصفح بدل تطبيق سطح المكتب، فإن Open WebUI يعمل بالطريقة نفسها.

المصادر: وثائق Cherry Studio، صفحتا المزوّد المخصص وإعدادات المزوّد، تم التحقق منها في 7 نوفمبر 2026؛ المشروع على github.com/CherryHQ/cherry-studio.