دليل ربط RikkaHub بخدمة وكيل API خارجية: دليل إعداد من 3 خطوات باستخدام APIYI وشرح الفروقات بين قنوات v1 و v1beta

ملاحظة من المؤلف: RikkaHub هو تطبيق أندرويد يدعم نماذج لغة كبيرة (LLM) متعددة. في هذا المقال، سنشرح بالتفصيل كيفية ربط خدمة وكيل API مثل APIYI، مع التركيز على الفرق بين نوعي القنوات /v1 و /v1beta وكيفية تجنب الأخطاء الشائعة.

باستخدامك لنماذج لغة كبيرة على هاتفك، لن تضطر بعد الآن للتنقل بين تطبيقات ChatGPT وGemini وClaude. يعد RikkaHub تطبيق أندرويد أصلياً يدعم الوصول إلى جميع النماذج الرئيسية عبر خدمة وكيل API خارجية. ومع ذلك، يقع العديد من المستخدمين في خطأ شائع عند الإعداد: استخدام نفس مفتاح API الذي يعمل بشكل مثالي مع جميع النماذج على تطبيق Cherry Studio على الكمبيوتر، لكنه لا يعمل في RikkaHub إلا مع نماذج Google، بينما تفشل نماذج GPT وClaude.

يكمن السبب في نوع القناة — الفرق بين /v1 و /v1beta. سنشرح في هذا المقال، باستخدام APIYI كمثال، تفاصيل هذا الإعداد بوضوح.

القيمة الأساسية: بعد قراءة هذا المقال، ستتعلم كيفية إعداد خدمة وكيل APIYI بشكل صحيح في RikkaHub، وستفهم الفرق بين /v1 و /v1beta لتتمكن من استدعاء جميع نماذج Claude وGPT وGemini من تطبيق واحد.

النقاط الجوهرية لربط RikkaHub بـ APIYI

النقطة	الشرح	الأهمية
اختيار نوع القناة	/v1 لكافة النماذج، /v1beta لـ Gemini فقط	بالغة الأهمية
Base URL	https://vip.apiyi.com/v1	انتبه للمسار في النهاية
مفتاح API	يُستخرج من منصة APIYI	مفتاح واحد لجميع النماذج
اختيار النموذج	أدخل اسم النموذج يدوياً أو اختره من القائمة	حسب احتياجك
طريقة الإعداد	إنشاء مزود (Provider) منفصل لكل نوع قناة	أفضل الممارسات

ما هو RikkaHub؟

RikkaHub هو تطبيق أندرويد مفتوح المصدر للدردشة مع نماذج اللغة الكبيرة (LLM)، تم تطويره باستخدام Kotlin و Jetpack Compose، ويتبع لغة تصميم Material You. تكمن ميزته الكبرى في دعم الربط مع عدة مزودي خدمات ذكاء اصطناعي في تطبيق واحد، مع إمكانية التبديل بين النماذج بحرية أثناء المحادثة.

المعلومات الأساسية	التفاصيل
رابط المصدر	github.com/rikkahub/rikkahub
أحدث إصدار	v2.1.7 (2026.3.28)
المنصات المدعومة	Android + Web
واجهات API المدعومة	متوافق مع OpenAI، أصلي لـ Google Gemini، متوافق مع Anthropic
الميزات الأساسية	تبديل النماذج، إدخال متعدد الوسائط، تكامل البحث، دعم MCP
طريقة التثبيت	Google Play / GitHub Release / الموقع الرسمي

تشمل أبرز ميزات RikkaHub:

• إدخال متعدد الوسائط: دعم الصور، ملفات PDF، وملفات DOCX
• تفرع الرسائل: استكشاف مسارات إجابات مختلفة ضمن المحادثة
• تكامل البحث: محركات بحث مدمجة مثل Exa و Tavily و Brave
• دعم MCP: متوافق مع بروتوكول سياق النموذج (Model Context Protocol)
• عرض Markdown: إبراز الكود، صيغ LaTeX، ومخططات Mermaid
• استيراد بطاقات الشخصيات: متوافق مع بطاقات شخصيات SillyTavern

---

دليل إعداد APIYI على RikkaHub بالكامل

الخطوة 1: الحصول على مفتاح API الخاص بـ APIYI

أولاً، احصل على مفتاح API من منصة APIYI:

1. قم بزيارة موقع APIYI (apiyi.com) وسجل حساباً
2. ادخل إلى لوحة التحكم وأنشئ مفتاح API
3. انسخ المفتاح واحفظه (يكون بالتنسيق sk-xxxxxxxx)

الخطوة 2: إضافة مزود (Provider) في RikkaHub

افتح RikkaHub ← الإعدادات (Settings) ← مزود الذكاء الاصطناعي (AI Provider) ← إضافة مزود جديد:

إعداد قناة متوافقة مع OpenAI (موصى به لجميع النماذج):

عنصر الإعداد	المحتوى المطلوب	الشرح
نوع المزود	OpenAI Compatible	اختر التوافق مع OpenAI
Base URL	https://vip.apiyi.com/v1	تأكد من وجود /v1 في النهاية
مفتاح API	مفتاح APIYI الخاص بك	sk-xxxxxxxx
اسم النموذج	أدخله حسب الحاجة	مثل claude-sonnet-4-20250514

الخطوة 3: اختيار النموذج وبدء المحادثة

بعد إتمام الإعداد، اختر النموذج المناسب من واجهة المحادثة للبدء. من خلال واجهة APIYI الموحدة، يمكنك استدعاء النماذج التالية في RikkaHub:

• سلسلة Claude: مثل claude-sonnet-4، claude-opus-4، إلخ.
• سلسلة GPT: مثل gpt-5.4، gpt-5.4-mini، إلخ.
• سلسلة Gemini: مثل gemini-2.5-pro، gemini-2.5-flash، إلخ.
• النماذج مفتوحة المصدر: مثل Llama 4، DeepSeek، إلخ.

🎯 بداية سريعة: بعد الحصول على مفتاح API من APIYI (apiyi.com)، ما عليك سوى إضافة مزود واحد في RikkaHub، وستتمكن من التبديل بحرية بين جميع نماذج الذكاء الاصطناعي الرائدة على هاتفك.

شرح مفصل لنوعي القنوات /v1 و /v1beta: أهم فروقات الإعداد

لماذا لا تعمل بعض النماذج على RikkaHub رغم استخدام نفس المفتاح؟

هذه هي المشكلة الأكثر شيوعاً التي يواجهها مستخدمو RikkaHub:

"لماذا يعمل نفس الرمز (Token) وAPI على برنامج Cherry Studio في الحاسوب، بينما على تطبيق RikkaHub في أندرويد لا يعمل إلا مع نماذج جوجل، ولا يمكنني استخدام GPT أو Claude؟"

السبب الجوهري: يحتوي تطبيق RikkaHub على نوعين من القنوات، واختيار النوع الخاطئ يؤدي إلى عدم توفر بعض النماذج.

الفروقات الجوهرية بين /v1 و /v1beta

الميزة	/v1 (متوافق مع OpenAI)	/v1beta (خاص بـ Gemini)
النماذج المتوافقة	Claude + GPT + Gemini + نماذج مفتوحة المصدر	سلسلة Gemini فقط
تنسيق API	تنسيق OpenAI Chat Completions	تنسيق Google Gemini الأصلي
مثال على Base URL	https://vip.apiyi.com/v1	https://vip.apiyi.com/v1beta
سيناريو الاستخدام	عام، الخيار الموصى به	عند الحاجة لميزات Gemini الخاصة
توافق نماذج Google	جيد	الأفضل

مزايا وقيود /v1beta

/v1beta هو تنسيق API الأصلي لنموذج Google Gemini. عند اختيار مسار /v1beta في RikkaHub، سيستخدم التطبيق تنسيق طلب Gemini الأصلي (وليس التنسيق المتوافق مع OpenAI) للتواصل مع الخادم.

المزايا:

• أفضل توافق مع نماذج Gemini.
• دعم الميزات الحصرية لـ Gemini (مثل Grounding وإعدادات الأمان).
• تنسيق استجابة أصلي دون الحاجة لتحويل البيانات.

القيود:

• مخصص فقط لسلسلة نماذج Gemini.
• نماذج غير جوجل مثل Claude وGPT لن تعمل نهائياً.
• نظراً لاختلاف تنسيق الطلب، ستظهر رسائل خطأ مباشرة عند محاولة استخدامه مع Claude/GPT.

خطة الإعداد الصحيحة

الخيار أ: استخدام /v1 فقط (موصى به لمعظم المستخدمين)

إذا كنت تستخدم مزيجاً من Claude وGPT وGemini، فما عليك سوى إنشاء مزود (Provider) متوافق مع OpenAI:

نوع المزود: OpenAI Compatible
Base URL: https://vip.apiyi.com/v1
API Key: sk-your-apiyi-key

هذا الإعداد يتيح لك استدعاء كافة النماذج المتاحة على APIYI، بما في ذلك Gemini.

الخيار ب: استخدام مزودين /v1 + /v1beta (للمستخدمين المتقدمين)

إذا كنت ترغب في الحصول على أفضل توافق ممكن لنماذج Gemini، يمكنك إنشاء مزودين:

المزود	النوع	Base URL	الاستخدام
المزود 1	OpenAI Compatible	https://vip.apiyi.com/v1	Claude / GPT / نماذج مفتوحة المصدر
المزود 2	Gemini	https://vip.apiyi.com/v1beta	سلسلة Gemini (توافق مثالي)

يستخدم كلا المزودين نفس مفتاح APIYI، وسيقوم التطبيق تلقائياً باختيار المزود المناسب بناءً على النموذج المختار أثناء المحادثة.

💡 نصيحة لتجنب المشاكل: إذا قمت بإنشاء مزود من نوع /v1beta فقط، فلن تعمل سوى نماذج Gemini. وهذا هو سبب شكوى العديد من المستخدمين من أنهم "لا يستطيعون استخدام سوى نماذج جوجل". الحل هو إضافة مزود إضافي من نوع /v1 أو استخدام /v1 كمزود وحيد.

أمثلة على إعدادات النماذج الشائعة في RikkaHub

جدول إعدادات النماذج الرائجة في RikkaHub

فيما يلي إعدادات النماذج المستخدمة بشكل شائع في RikkaHub عبر منصة APIYI:

النموذج	معرف النموذج (Model ID)	نوع القناة	الاستخدام الموصى به
Claude Sonnet 4	claude-sonnet-4-20250514	/v1	المحادثات اليومية، التحليل
Claude Opus 4	claude-opus-4-20250514	/v1	الاستنتاج المعقد
GPT-5.4	gpt-5.4	/v1	النموذج الرائد العام
GPT-5.4 Mini	gpt-5.4-mini	/v1	خفيف وعالي الكفاءة
Gemini 2.5 Pro	gemini-2.5-pro	/v1 أو /v1beta	نافذة السياق الطويلة
Gemini 2.5 Flash	gemini-2.5-flash	/v1 أو /v1beta	استجابة سريعة
DeepSeek V3	deepseek-chat	/v1	استنتاج فعال من حيث التكلفة
Llama 4 Maverick	meta-llama/llama-4-maverick	/v1	أفضل النماذج مفتوحة المصدر

نصائح الإعداد المتقدمة في RikkaHub

رؤوس HTTP مخصصة: يدعم RikkaHub رؤوس الطلبات المخصصة، إذا كنت بحاجة إلى تمرير معلمات إضافية:

Headers:
  X-Custom-Header: your-value

استيراد/تصدير رمز الاستجابة السريعة (QR Code): يمكنك إنشاء رمز QR لإعدادات المزود، مما يسهل مشاركتها مع الأصدقاء أو المزامنة بين أجهزة متعددة.

متغيرات الموجه (Prompt): يدعم استخدام متغيرات في الموجه النظامي مثل {model} (اسم النموذج الحالي)، و {timestamp} (الطابع الزمني).

🚀 نصيحة لزيادة الكفاءة: من خلال الواجهة الموحدة لـ APIYI (apiyi.com)، تحتاج فقط إلى مفتاح API واحد للتبديل بحرية بين جميع النماذج الرئيسية مثل Claude وGPT وGemini وDeepSeek داخل RikkaHub. وبالاقتران مع ميزة تفرع المحادثة في RikkaHub، يمكنك مقارنة جودة إجابات النماذج المختلفة بسرعة.

---

مقارنة بين RikkaHub وعملاء AI الآخرين على أندرويد

أبعاد المقارنة	RikkaHub	تطبيق ChatGPT	تطبيق Gemini	تطبيق Claude
دعم نماذج متعددة	جميع النماذج	GPT فقط	Gemini فقط	Claude فقط
API مخصص	مدعوم	غير مدعوم	غير مدعوم	غير مدعوم
خدمة وكيل API خارجية	مدعوم	غير مدعوم	غير مدعوم	غير مدعوم
مفتوح المصدر	نعم	لا	لا	لا
دعم MCP	نعم	لا	لا	لا
تكامل البحث	محركات متعددة	بحث ChatGPT	Google	لا يوجد
السعر	مجاني	اشتراك	اشتراك	اشتراك

تكمن الميزة التنافسية الكبرى لـ RikkaHub في: تطبيق واحد يغنيك عن كل نماذج الذكاء الاصطناعي. وبفضل منصات خدمة وكيل API مثل APIYI، لن تحتاج بعد الآن إلى الدفع بشكل منفصل لكل مزود خدمة ذكاء اصطناعي أو تثبيت تطبيقات متعددة.

🎯 نصيحة اختيار النموذج: إذا كنت تستخدم خدمة ذكاء اصطناعي واحدة فقط (مثل ChatGPT فقط)، فإن استخدام التطبيق الرسمي أكثر ملاءمة. ولكن إذا كنت، مثل معظم المطورين، بحاجة إلى التبديل بين نماذج متعددة، فإن RikkaHub + APIYI (apiyi.com) هو الحل الأكثر مرونة على نظام أندرويد.

---

استكشاف أخطاء ربط RikkaHub بمنصة APIYI وإصلاحها

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

مظهر المشكلة	السبب	الحل
Gemini يعمل فقط، بينما تظهر أخطاء في النماذج الأخرى	تم اختيار نوع القناة /v1beta	قم بتغييره إلى /v1 أو أنشئ مزوداً (Provider) متوافقاً مع OpenAI
جميع النماذج تظهر أخطاء	خطأ في كتابة رابط القاعدة (Base URL)	تأكد من أنه https://vip.apiyi.com/v1
فشل المصادقة	مفتاح API خاطئ أو منتهي الصلاحية	تحقق من حالة المفتاح في لوحة تحكم APIYI
النموذج غير موجود	خطأ في كتابة معرف النموذج (Model ID)	راجع وثائق APIYI للتأكد من معرف النموذج الصحيح
تنسيق الاستجابة غير طبيعي	عدم تطابق بين نوع القناة والنموذج	استخدم /v1beta لـ Gemini، و /v1 للنماذج الأخرى

---

الأسئلة الشائعة

س1: هل يجب أن أختار /v1 أم /v1beta؟

في معظم الحالات، اختر /v1. التنسيق /v1 متوافق مع OpenAI ويدعم جميع النماذج (بما في ذلك Gemini). أما /v1beta فهو التنسيق الأصلي لـ Gemini، ويدعم نماذج Gemini فقط ولكنه يوفر توافقية أفضل. إذا كنت تستخدم Claude و GPT بشكل أساسي، فاختر /v1. وإذا كنت تحتاج إلى أفضل تجربة لـ Gemini في نفس الوقت، يمكنك إنشاء مزودين (Providers) واستخدام كل منهما على حدة. يمكنك استخدام نفس مفتاح API من منصة APIYI apiyi.com لتهيئة كلا النوعين من القنوات.

س2: ماذا أفعل إذا كان التطبيق يعمل على Cherry Studio ولكن ليس على RikkaHub؟

السبب الأكثر شيوعاً هو خطأ في تهيئة نوع القناة. يستخدم Cherry Studio التنسيق المتوافق مع OpenAI (/v1) افتراضياً، وإذا اخترت نوع Gemini (/v1beta) في RikkaHub، فلن تعمل النماذج غير التابعة لـ Google. الحل: أنشئ مزوداً جديداً من نوع OpenAI Compatible، واكتب في رابط القاعدة (Base URL) https://vip.apiyi.com/v1.

س3: هل تطبيق RikkaHub مجاني؟

تطبيق RikkaHub نفسه مجاني ومفتوح المصدر، ولكن استدعاء نماذج الذكاء الاصطناعي يتطلب تكاليف API. يمكنك الحصول على مفتاح API من خلال منصة APIYI apiyi.com والدفع حسب الاستخدام الفعلي، دون رسوم شهرية أو اشتراكات. مقارنة بالاشتراك في ChatGPT Plus (20 دولاراً/شهرياً) و Claude Pro (20 دولاراً/شهرياً) و Gemini Advanced (19.99 دولاراً/شهرياً)، فإن استخدام نظام الدفع حسب الاستخدام عبر APIYI + RikkaHub غالباً ما يكون أكثر توفيراً.

---

ملخص

النقاط الجوهرية لربط RikkaHub بخدمة وكيل API تابعة لجهة خارجية:

1. نوع القناة هو المفتاح: المسار /v1 متوافق مع جميع نماذج اللغة الكبيرة (Claude/GPT/Gemini/النماذج مفتوحة المصدر)، بينما /v1beta متوافق فقط مع Gemini ولكنه يوفر توافقية أفضل مع نماذج Google.
2. نوصي بخطة المزود المزدوج: استخدام /v1 كقناة عامة + /v1beta كقناة مخصصة لـ Gemini، ويمكنك استخدام نفس مفتاح API الخاص بـ APIYI لكلا الغرضين.
3. تطبيق واحد لكل شيء: يتيح لك الجمع بين RikkaHub و APIYI (apiyi.com) حرية التنقل الكاملة بين نماذج Claude وGPT وGemini وغيرها على نظام Android.

لن تحتاج بعد الآن إلى التبديل بين ثلاثة أو أربعة تطبيقات ذكاء اصطناعي مختلفة. نوصي بالحصول على مفتاح API عبر APIYI (apiyi.com)، حيث يغطي مفتاح واحد جميع النماذج الرئيسية، مما يتيح لك تحويل هاتفك إلى مساعد ذكاء اصطناعي شامل باستخدام RikkaHub.

---

📚 المراجع

1. مستودع RikkaHub على GitHub: الكود المصدري وأحدث إصدارات التحميل

   • الرابط: github.com/rikkahub/rikkahub
   • الوصف: يتضمن الكود المصدري الكامل، روابط التحميل، وشرح الميزات.

2. الوثائق الرسمية لـ RikkaHub: دليل إعداد المزود (Provider) وطرق الاستخدام

   • الرابط: docs.rikka-ai.com
   • الوصف: يحتوي على طرق إعداد مفصلة لمختلف أنواع المزودين.

3. مركز وثائق APIYI: الحصول على مفتاح API وقائمة النماذج

   • الرابط: docs.apiyi.com
   • الوصف: يتضمن معرفات جميع النماذج المدعومة، الأسعار، وأمثلة على استدعاء النموذج.

---

المؤلف: فريق APIYI التقني
النقاش التقني: نرحب بمشاركتكم لتجارب إعداد RikkaHub في قسم التعليقات، وللمزيد من المعلومات حول ربط نماذج الذكاء الاصطناعي، يمكنكم زيارة مركز وثائق APIYI على docs.apiyi.com.