استخدام Cherry Studio بمفتاح API من خبير: الإعداد خطوة بخطوة

لاستخدام Cherry Studio بمفتاح من خبير، افتح Settings ثم Model Provider، وأضف مزوّدًا مخصّصًا. الصق مفتاحك في حقل API Key، واكتب العنوان https://api.5abeer.ai في حقل Anthropic إذا كان المفتاح لنماذج Claude، أو في حقل OpenAI إذا كان لنماذج GPT. ثم زامن النماذج وأضف ما تريده منها، وشغّل المزوّد، واختر نموذجًا.

ماذا تحتاج قبل أن تبدأ؟#

• تطبيق Cherry Studio لسطح المكتب على Windows أو macOS أو Linux. نزّله من صفحة التنزيل الرسمية بالنسخة التي تناسب نظامك ومعالجك. وفي 2026-11-03 كان أحدث إصدار هو 2.1.10، الصادر في 2026-10-31.
• مفتاح API من خبير لمزوّد النماذج التي تريدها. فالمفتاح يعمل مع نماذج مزوّد واحد فقط (إنشاء مفتاح). وإن كانت هذه أول مرة تستخدم فيها مفتاحًا، فراجع ما هو مفتاح API.
• رصيد في حسابك (طرق الدفع).

وليست العربية من لغات واجهة Cherry Studio في الإصدار 2.1.10، لذلك نكتب أسماء الأزرار والحقول بالإنجليزية كما تظهر في واجهته الإنجليزية.

ولا تعمل باقة خبير هنا. فالباقات مخصّصة للتطبيقات المدعومة، وCherry Studio ليس منها، لذلك يعمل بمفتاح API يُدفع استخدامه من رصيدك.

أي نقطة اتصال تختار؟#

يسألك المزوّد المخصّص عن صيغة الواجهة البرمجية التي يستخدمها، أي نقطة الاتصال. تعرض النافذة الخيارين OpenAI وAnthropic، ويضيف زر More options الخيارين OpenAI Responses وGemini. اختر ما يطابق مفتاحك:

• Anthropic: لمفتاح Claude. خبير متوافق مع واجهة Anthropic Messages.
• OpenAI: لمفتاح GPT. خبير متوافق مع OpenAI.
• Gemini: من More options، لمفتاح Gemini.

واكتب في أيٍّ منها العنوان الجذر نفسه: https://api.5abeer.ai. ويضيف Cherry Studio المسار /v1 في OpenAI وAnthropic، والمسار /v1beta في Gemini، ويعرض المسار النهائي في سطر Request path تحت الحقل قبل أن تحفظ. وهذه عناويننا الأساسية:

كيف تُعدّ Cherry Studio خطوة بخطوة؟#

1. 1

   أنشئ مفتاح API في خبير#

   من لوحة التحكم افتح الـ API ← المفاتيح، واضغط مفتاح جديد، واختر Claude. وانسخ المفتاح عندما يظهر.

2. 2

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

   في Cherry Studio افتح Settings من أيقونة الترس، ثم Model Provider، واضغط Add Provider. فتظهر نافذة Add Custom Provider.

3. 3

   املأ الحقول#

   • Provider Name: اسم تعرفه، مثل 5abeer Claude.
   • API Key: مفتاحك من خبير.
   • Endpoint settings: اكتب https://api.5abeer.ai في حقل Anthropic، واترك حقل OpenAI فارغًا. ويجب أن ينتهي سطر Request path بالمسار /v1/messages.

   ثم اضغط Add.

4. 4

   زامن النماذج#

   في صفحة المزوّد اضغط Sync models، فيطلب Cherry Studio من خبير النماذج التي يستطيع مفتاحك استخدامها، ويعرضها في نافذة Model management. أضف ما تريده منها بزر +، فالنماذج المضافة وحدها تظهر عند اختيار نموذج في المحادثة. وإذا لم تجد نموذجًا، فاضغط زر + بجوار Sync models (Add model manually)، واكتب معرّفه في حقل Model ID كما يظهر في قائمة النماذج تمامًا.

5. 5

   تحقّق من الاتصال#

   اضغط Model Check بجوار حقل API Key، واختر نموذجًا واحدًا من Select Model، ثم اضغط Start، فيرسل Cherry Studio طلبًا حقيقيًا قصيرًا بمفتاحك. وإذا فشل التحقق، فابحث في قائمة المزوّد عن نموذج كُتب اسمه خطأً أو لا يدعمه مفتاحك.

6. 6

   شغّل المزوّد#

   فعّل زر التشغيل في أعلى يمين صفحة المزوّد. فلا تظهر نماذجه في المحادثات إلا وهو مفعّل.

7. 7

   أرسل رسالة تجربة#

   افتح محادثة جديدة، واختر claude-sonnet-5.5، وأرسل رسالة قصيرة. إذا وصلك رد، فالإعداد يعمل.

أي نموذج تستخدم في Cherry Studio؟#

ابدأ بنموذج claude-sonnet-5.5 للمحادثة اليومية والكتابة وأسئلة البرمجة. وانتقل إلى claude-opus-5.5 في المهام الطويلة والصعبة التي تستحق تكلفتها الأعلى.

اجعل claude-sonnet-5.5 هو Default Assistant Model من Settings ← Default Model، وأعطِ المساعد الذي تستخدمه في المهام الصعبة وحده نموذجه الخاص claude-opus-5.5. فالنموذج الذي تختاره لمساعد يُقدَّم على النموذج الافتراضي. وهذه نماذج Claude الحالية:

والسعر الرسمي بجوار سعرنا، مع تاريخ قراءته:

أما نماذج GPT وGemini فتحتاج إلى مفتاح لمزوّدها. وهذه نماذج المحادثة الحالية لكلٍّ منهما:

وأسعارنا بجوار الأسعار الرسمية في Claude API وOpenAI API.

أي إعدادات في Cherry Studio تحدد ما تدفعه؟#

يُدفع كل طلب من رصيدك بعدد التوكنات التي يستخدمها، بسعر النموذج في خبير (الأسعار والرصيد). ومع الواجهة البرمجية تستخدم كل نموذج بسعر لكل توكن أقل من سعره الرسمي.

وثلاثة إعدادات تحدد حجم طلبات محادثتك، والنموذج الذي ينفّذ الطلبات التي يرسلها Cherry Studio من تلقاء نفسه. وطابقناها مع الإصدار 2.1.10 في 2026-11-03:

• Quick Model، من Settings ← Default Model. يستخدمه Cherry Studio في مهام صغيرة، مثل تسمية المحادثات واستخراج كلمات البحث. وما دام فارغًا فإنه يتبع Default Assistant Model، وإذا اخترت نموذجًا افتراضيًا وهو فارغ نُسخ النموذج نفسه إليه. فانظر إلى ما يعرضه: إذا كان claude-opus-5.5، فهذا النموذج هو الذي يكتب عنوان كل محادثة. اجعله claude-sonnet-5.5. ولإيقاف طلبات التسمية، اضغط زر الترس بجوار Quick Model وأوقف Conversation Auto Naming. ويتبع Translate Model القاعدة نفسها.
• Recent messages kept، من Settings ← General ← Context Management. هذا الحقل فارغ في الأصل، فتحمل كل رسالة جديدة المحادثة كلها معها. وإذا كتبت رقمًا مثل 20، فلا تُرسَل إلا آخر 20 رسالة، لكن الرقم الصغير جدًا يُنسي النموذج تعليمات سابقة. ويستطيع كل مساعد أن يحدد قيمته الخاصة.
• Auto compress، في الصفحة نفسها، وهو مفعّل في الأصل. فعندما تقترب المحادثة من حد السياق الذي يقبله النموذج، يلخّص Cherry Studio الرسائل الأقدم بنموذج المحادثة نفسه. اختر claude-sonnet-5.5 في حقل Compression model، لتُلخَّص المحادثات الطويلة على claude-opus-5.5 بالسعر الأقل.

وعادتان أخريان:

• تحقّق من نموذج واحد، لا من كل النماذج. فكل تحقق طلب حقيقي مدفوع، وينبّه Cherry Studio إلى أن زر Check all models قد يكلّف كثيرًا في وقت قصير.
• خصّص لـ Cherry Studio مفتاحًا مستقلًا، عليه حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP المسموح بها (التحكم في المفاتيح).

هل تستخدم Claude وGPT في التطبيق نفسه؟#

نعم، بمزوّد مستقل في Cherry Studio لكل مفتاح. فمفتاح خبير يعمل مع نماذج مزوّد واحد، وإذا طلبت نموذج GPT بمفتاح Claude يصلك الخطأ MODEL_PLATFORM_NOT_ALLOWED. ولإضافة GPT، أنشئ مفتاحًا لنماذج GPT، ثم أضف مزوّدًا مخصّصًا ثانيًا باسم مثل 5abeer GPT، واكتب https://api.5abeer.ai في حقل OpenAI، والصق مفتاح GPT في حقل API Key. ثم زامن نماذجه وأضفها وتحقّق منها وشغّله كما سبق.

ويُدفع استخدام المزوّدين من الرصيد نفسه.

ولا تضع مفتاحين لمزوّدين مختلفين في مزوّد واحد داخل Cherry Studio. فهو يقبل أكثر من مفتاح للمزوّد الواحد ويستخدمها بالتناوب، فتخرج بعض الطلبات بالمفتاح الخطأ.

الأخطاء الشائعة وحلولها#

• INVALID_API_KEY أو الرمز 401: في المفتاح خطأ في الكتابة أو مسافة زائدة، أو أنه أُلغي. الصقه من جديد في صفحة المزوّد.
• MODEL_PLATFORM_NOT_ALLOWED: النموذج لمزوّد غير مزوّد المفتاح. اختره من المزوّد في Cherry Studio الذي يحمل مفتاح هذا النموذج.
• رسالة `not found` أو مسار خاطئ: في العنوان مسار كامل مثل /v1/chat/completions، أو ينتهي بعلامة # التي تمنع Cherry Studio من إضافة الإصدار. اكتب https://api.5abeer.ai وحده، وراجع سطر Request path.
• لا تظهر نماذج خبير في المحادثة: المزوّد متوقف، أو زامنت النماذج دون أن تضيف منها شيئًا.
• نموذج غير موجود: المعرّف الذي كتبته لا يطابق معرّفنا. انسخه من قائمة النماذج.
• INSUFFICIENT_BALANCE: اشحن رصيدك، ثم أعد المحاولة.

وكل الرموز ومعانيها في الأخطاء وحلولها.

أسئلة شائعة#

هل يجب أن ينتهي العنوان بالمسار /v1؟#

لا يلزم ذلك. فـ Cherry Studio يضيف /v1 بنفسه، وإذا كتبت https://api.5abeer.ai/v1 فإنه يرى الإصدار في العنوان ولا يضيفه مرة ثانية.

لماذا لا يُظهر زر Sync models إلا نماذج Claude؟#

لأن القائمة تأتي من مفتاحك، والمفتاح يعمل مع نماذج مزوّد واحد. ولترى نماذج GPT، أضف مزوّدًا ثانيًا بمفتاح GPT.

لماذا أرى في استخدامي طلبات لم أكتبها؟#

هذه مهام صغيرة يرسلها Cherry Studio بنفسه، مثل تسمية المحادثة أو استخراج كلمات البحث. وهي تعمل على Quick Model، وتُدفع مثل أي طلب. وتُكتب ملخّصات المحادثات الطويلة أيضًا في الخلفية، على Compression model. اجعل Quick Model نموذجًا أخف، أو أوقف Conversation Auto Naming، كما في إعدادات التكلفة.

هل أستخدم مفتاحي مع الوكيل في Cherry Studio؟#

نعم. في الإصدار 2.1.10 يكون Runtime mode للوكيل أحد خيارين: Claude Agent، الذي يستخدم صيغة Anthropic من مزوّد Claude عندك، أو Pi، الذي يعمل أيضًا مع المزوّدات التي تستخدم صيغة OpenAI، مثل مزوّد يحمل مفتاح GPT. وتُدفع طلبات الوكيل من رصيدك، لذلك ضع حدًّا للإنفاق على هذا المفتاح.

المصادر#

راجعناها في 2026-11-03:

• وثائق Cherry Studio بالصينية: إعدادات مزوّد النماذج والمزوّد المخصّص وAnthropic والنماذج الافتراضية والمحادثات الطويلة والسياق والتثبيت
• Cherry Studio على GitHub: الإصدار v2.1.10، والكود المصدري لهذا الإصدار في لغات الواجهة وأسماء الواجهة الإنجليزية ونافذة Model Check وارتباط Quick Model بالنموذج الافتراضي وأنماط تشغيل الوكيل
• وثائق خبير: المفاتيح والمصادقة والعناوين الأساسية وقائمة النماذج والأخطاء وحلولها