تخطَّ إلى المحتوى
موارد المطورين
موارد المطورين

Cherry Studio

اربط Cherry Studio بـ RunAPI وتحقق من الدردشة.

اربط Cherry Studio بـ RunAPI باستخدام مزوّد OpenAI مخصص. أنشئ مفتاح API قياسياً لـ RunAPI في دليل المصادقة قبل المتابعة.

تثبيت Cherry Studio

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

إضافة موفر RunAPI

  1. افتح الإعدادات -> خدمات النماذج -> + إضافة.
  2. اضبط اسم الموفر على RunAPI ونوع الموفر على OpenAI.
  3. أدخل مفتاح API الخاص بك في RunAPI واضبط عنوان API على https://runapi.ai/v1.
  4. أضف معرّف نموذج دقيقاً من كتالوج النماذج، وفعِّل الموفر واحفظ.

نظراً لأن نوع المزوّد هو OpenAI، يستخدم هذا الحقل عنوان URL الأساسي المتوافق مع OpenAI الخاص بـ RunAPI، والذي يتضمن /v1. يُضيف Cherry Studio /chat/completions لطلب Chat Completions، لذا لا تلصق عنوان URL الكامل للعملية في حقل عنوان API.

اختر نموذجاً

تعتمد الموفّرات المخصصة على النماذج التي تضيفها. إذا كانت قائمة الاختيار فارغة، ارجع إلى منطقة إدارة نماذج الموفّر وأضف معرّف RunAPI الدقيق يدوياً. إضافة نموذج لا تمنحه قدرات لا يدعمها.

تشغيل فحص الاتصال

شغِّل فحص الاتصال بالنموذج المحفوظ. يُرسل هذا طلب نموذج بدلاً من التحقق من تنسيق المفتاح فحسب. يؤكد الفحص الناجح أن عنوان URL للمزود والمفتاح والنموذج المحدد تعمل معاً.

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

ابدأ محادثة جديدة، وحدد مزود RunAPI والنموذج، ثم أرسل Reply with the word connected. تؤكد الاستجابة الكاملة أو المتدفقة الطبيعية أن المحادثة النشطة تستخدم RunAPI.

استكشاف الأخطاء وإصلاحها

  • محدد النموذج فارغ: أضف معرّف النموذج الدقيق في منطقة إدارة نماذج المزوّد المخصص وتأكد من تفعيل المزوّد.
  • فشل فحص الاتصال: تأكد من اختيار نموذج، واستبدل المفتاح بمفتاح قياسي صالح، ثم أعد المحاولة.
  • يُعيد الطلب 404: استخدم https://runapi.ai/v1 كعنوان API؛ لا تُضف /chat/completions بنفسك.
  • يعمل Text لكن vision أو tools يفشل: اختر نموذجاً يُعلن الميزة المطلوبة في كتالوج النماذج.

للاطلاع على سلوك البروتوكول المشترك، استخدم البدء السريع لـ LLM API . للاطلاع على حقول الطلب والاستجابة، استخدم مرجع Chat Completions API .