ملاحظة من الكاتب: يُعد banana-slides تطبيقاً مفتوح المصدر لتوليد عروض PPT باستخدام الذكاء الاصطناعي، وهو مبني على نموذج nano banana pro. في هذا المقال، سنشرح للمبتدئين عملية النشر عبر Fork، وسنوضح كيفية استبدال وكيل AIHubMix الافتراضي بخدمة APIYI، لضمان استدعاء أكثر استقراراً للنماذج.
يوجد على GitHub أداة شهيرة جداً ومفتوحة المصدر لتوليد عروض PPT باستخدام الذكاء الاصطناعي تُدعى banana-slides، وهي مبنية على أحدث نموذج صور من جوجل nano banana pro. تركز الأداة على "توليد عروض PPT قابلة للتعديل بجملة واحدة، ودعم تصدير الفيديو، وتعديل أي منطقة باستخدام اللغة الطبيعية"، وقد حصدت حتى الآن أكثر من 14 ألف نجمة على GitHub.
هذه ليست مجرد أداة أخرى تعتمد على واجهات جاهزة، بل هي نظام "Vibe PPT" حقيقي يمكن نشره محلياً ومفتوح المصدر بالكامل، ويدعم تنسيقات نماذج متعددة مثل Gemini وOpenAI وAnthropic وVertex AI. توصي الوثائق الرسمية افتراضياً باستخدام AIHubMix كوكيل.
القيمة الجوهرية: بعد قراءة هذا المقال، ستتعلم كيفية عمل Fork لمشروع banana-slides وإكمال عملية النشر محلياً، والأهم من ذلك، إتقان طريقة الإعداد الكاملة لاستبدال وكيل AIHubMix الافتراضي بخدمة APIYI (apiyi.com)، للاستمتاع بمزايا التكلفة المنخفضة، وعدم وجود قيود على التزامن، ودعم التنسيقات الأصلية، بالإضافة إلى عرض شحن 100 دولار والحصول على 10% إضافية.
أولاً: ما هو banana-slides: الركائز الثلاث الأساسية لمولد عروض PPT بالذكاء الاصطناعي
مشروع banana-slides هو مشروع مفتوح المصدر يقوده المطور Anionex، ويتمثل في كونه تطبيقاً أصلياً لتوليد عروض PPT باستخدام الذكاء الاصطناعي استناداً إلى نموذج nano banana pro. فلسفته الأساسية هي "Vibe PPT" – حيث يمكنك استخدام لغة المحادثة لتوجيه الذكاء الاصطناعي لتوليد، وتعديل، وتطوير أي شريحة عرض.
1.1 الموقع الجوهري لـ banana-slides
| بُعد الموقع | خصائص banana-slides | الفرق عن أدوات PPT التقليدية بالذكاء الاصطناعي |
|---|---|---|
| النموذج الأساسي | يعتمد على توليد الصور بـ nano banana pro | معظم الأدوات تستخدم قوالب جاهزة |
| نمط النشر | مفتوح المصدر بالكامل + نشر محلي | منتجات SaaS محبوسة في السحابة |
| الترخيص | AGPL-3.0 (يتطلب ترخيصاً للاستخدام التجاري) | نظام اشتراك مغلق المصدر |
| طريقة التعديل | "تعديل Vibe" باللغة الطبيعية | تعديل يدوي بالسحب والإفلات |
| مواد الإدخال | أي تنسيق PDF/DOCX/MD/TXT | يدعم النصوص/المخططات فقط |
| تنسيق التصدير | PPTX قابل للتعديل + PDF + MP4 (مع دبلجة TTS) | معظمها يدعم PPTX فقط |
| مزود API | يدعم العديد، ويوصي افتراضياً بـ AIHubMix | عادة ما يرتبط بمزود واحد فقط |
1.2 لماذا يستحق banana-slides اهتمام المبتدئين؟
إذا كنت قد بدأت للتو في مجال توليد عروض PPT بالذكاء الاصطناعي، فإن banana-slides يوفر خياراً أكثر "حرية" من خدمات SaaS التجارية:
- كود مفتوح المصدر بالكامل: يمكن إجراء تطوير ثانوي ونشر خاص.
- جودة صور متميزة: يعتمد على nano banana pro، والصور المولدة تتفوق بكثير على قوالب PPT التقليدية.
- توافق مع نماذج متعددة: يمكنك استخدام أي نموذج من Gemini أو OpenAI أو Anthropic كخلفية.
- استبدال مرن للـ API: يوصي افتراضياً بـ AIHubMix، ولكن يمكنك استبداله تماماً بخدمات أخرى متوافقة (مثل APIYI apiyi.com).
💡 نصيحة للمبتدئين: إذا لم يكن لديك مفتاح API لـ Google أو OpenAI، فإن أسهل طريقة هي استخدام خدمة وكيل APIYI (apiyi.com)، حيث يمكن لمفتاح واحد الوصول إلى كامل سلسلة نماذج Gemini وClaude وGPT، مما يجنبك عناء تقديم طلبات حسابات متعددة بشكل منفصل.
1.3 من هم المستخدمون المستهدفون لـ banana-slides؟
- الطلاب: لإنجاز واجباتهم الدراسية وعروض مناقشة التخرج بسرعة.
- المعلمون: لتحويل محتوى المناهج إلى شرائح تعليمية غنية بالصور والنصوص.
- الموظفون: للمقترحات التجارية، وتقارير المشاريع، والملخصات الربع سنوية.
- المطورون: الفرق التي ترغب في نشر أدوات PPT بالذكاء الاصطناعي محلياً.
- المصممون: لاستلهام الأفكار من التخطيطات التي يولدها الذكاء الاصطناعي.
2. banana-slides الميزات الجوهرية: شرح لـ 4 خصائص رئيسية
تم تصميم وظائف banana-slides حول هدف أساسي وهو "خفض عتبة إنشاء عروض PowerPoint التقديمية"، وتتضمن بشكل رئيسي 4 مستويات من القدرات.
2.1 توليد المحتوى عبر مسارات متعددة
يدعم banana-slides ثلاث طرق لإدخال المحتوى، لتناسب سيناريوهات مختلفة:
| طريقة الإدخال | سيناريو الاستخدام | دقة المخرجات |
|---|---|---|
| التوليد بجملة واحدة | العروض التقديمية السريعة، المسودات الأولية | يقوم الذكاء الاصطناعي بتوليد المخطط + جميع الشرائح تلقائياً |
| وضع المخطط | هيكل واضح مسبقاً | توسيع محتوى كل شريحة بناءً على المخطط |
| وضع وصف الصفحة | تحكم دقيق | تحديد النص + الصور لكل شريحة على حدة |
2.2 التحليل الذكي للمواد
يمكن لـ banana-slides قبول ملفات مواد بتنسيقات متعددة واستخراج المعلومات الأساسية منها تلقائياً:
- PDF: استخراج النصوص والصور وبيانات الرسوم البيانية تلقائياً.
- DOCX: تحليل هيكل الفصول والصور المضمنة.
- Markdown: الحفاظ على علاقات التسلسل الهرمي H1/H2.
- TXT: استخراج النقاط الرئيسية بذكاء.
هذا يعني أنه يمكنك سحب وثيقة تقنية مباشرة إلى banana-slides، وترك الذكاء الاصطناعي يحولها إلى عرض تقديمي كامل.
2.3 "تحرير Vibe" باللغة الطبيعية
هذه هي الميزة الأكثر ابتكاراً في banana-slides. بعد إنشاء العرض التقديمي، يمكنك تعديل أي شريحة باستخدام اللغة الطبيعية:
- "اجعل الصفحة 3 بأسلوب تحليل الحالة"
- "أضف خلفية برتقالية للعنوان"
- "الصورة في هذه الصفحة معقدة جداً، استبدلها بأسلوب خطوط بسيط"
سيقوم الذكاء الاصطناعي بتحديد موقع التعديل بدقة وإعادة التوليد، وطريقة التفاعل هذه تشبه إلى حد كبير "التحدث مع مصمم حقيقي".
🎯 نصيحة للاستخدام: سيؤدي تحرير Vibe إلى تشغيل استدعاءات API متعددة (كل تعديل هو عبارة عن موجه كامل + توليد صورة). إذا كنت تعمل على عرض تقديمي طويل (أكثر من 20 شريحة)، نوصي باستخدام خدمة وكيل APIYI (apiyi.com) لتجنب مشاكل قيود السرعة في الواجهات الرسمية.
2.4 التصدير بتنسيقات متعددة
| تنسيق التصدير | الميزات | سيناريو الاستخدام |
|---|---|---|
| PPTX قابل للتحرير | النصوص والصور والأشكال قابلة للتعديل | الحاجة إلى تعديلات دقيقة لاحقاً |
| PPTX كصور | كل شريحة عبارة عن صورة عالية الدقة | منع حدوث أخطاء في التنسيق |
| عرض مستقر عبر المنصات | التوزيع والطباعة | |
| فيديو MP4 | يتضمن تعليقاً صوتياً (TTS) + ترجمة | الدروس المسجلة، الشرح التلقائي |
يدعم تصدير MP4 التعليق الصوتي (TTS) باللغات الصينية والإنجليزية واليابانية، مع إمكانية اختيار أصوات متعددة، وهو مفيد بشكل خاص للسيناريوهات التعليمية.
ثالثاً: عمل Fork والنشر المحلي لـ banana-slides: 3 خطوات للبدء السريع
3.1 متطلبات بيئة النظام
قبل نشر banana-slides، يرجى التأكد من توفر المتطلبات التالية في بيئتك المحلية:
| التبعية | متطلبات الإصدار | ملاحظات |
|---|---|---|
| Docker | 20.x+ | يُنصح بالنشر عبر Docker Compose |
| Python | 3.10+ | مطلوب للنشر من المصدر |
| Node.js | 16+ | مطلوب لتطوير الواجهة الأمامية |
| LibreOffice | اختياري | لتحليل ملفات PPTX المرفوعة |
| Git | أي إصدار | لعمل Fork والاستنساخ |
3.2 الخطوة الأولى: عمل Fork للمستودع إلى حسابك الخاص
افتح الصفحة الرئيسية للمشروع على GitHub عبر الرابط github.com/Anionex/banana-slides، واضغط على زر Fork في الزاوية العلوية اليمنى لنسخ المستودع إلى حسابك. فوائد الـ Fork:
- إمكانية رفع تعديلاتك الخاصة لاحقاً (خاصة إعدادات الـ API)
- سهولة التعامل مع التعارضات عند سحب التحديثات من المستودع الأصلي
- تسهيل النشر ضمن فريق العمل
بعد الانتهاء من الـ Fork، قم باستنساخ المستودع محلياً:
# استبدل YOUR_USERNAME باسم مستخدم GitHub الخاص بك
git clone https://github.com/YOUR_USERNAME/banana-slides.git
cd banana-slides
3.3 الخطوة الثانية: إنشاء ملف الإعدادات
قم بنسخ ملف الإعدادات النموذجي لإنشاء ملف الإعدادات الفعلي:
cp .env.example .env
يحتوي ملف .env على جميع مفاتيح الـ API، وعنوان الـ Base URL، واختيارات النماذج، وسنشرح في الفصل التالي بالتفصيل كيفية استبدالها بخدمة وكيل APIYI.
3.4 الخطوة الثالثة: التشغيل باستخدام Docker Compose
أبسط طريقة للتشغيل هي استخدام Docker Compose:
docker compose -f docker-compose.prod.yml up -d
بعد التشغيل، يمكنك الوصول إلى:
- واجهة المستخدم:
http://localhost:3000 - واجهة API الخلفية:
http://localhost:5000
إذا كنت ترغب في التشغيل من المصدر (لتسهيل التطوير الإضافي)، يمكنك تشغيل الخلفية والواجهة الأمامية بشكل منفصل:
# الخلفية
uv sync
uv run alembic upgrade head
uv run python app.py
# الواجهة الأمامية (في نافذة طرفية جديدة)
cd frontend
npm install
npm run dev
3.5 التحقق من نجاح عملية النشر
افتح http://localhost:3000، يجب أن ترى:
- ✅ الصفحة الرئيسية لـ banana-slides (بثيم الموز الأصفر)
- ✅ زر "إنشاء عرض تقديمي جديد" (New PPT) يعمل
- ✅ إمكانية إنشاء عرض تقديمي بعد إدخال موضوع قصير
إذا ظهر خطأ "API connection failed" أثناء الإنشاء، فعادةً ما يكون السبب خطأ في مفتاح الـ API أو الـ Base URL داخل ملف .env. راجع الفصل التالي لاستبدالها بخدمة وكيل APIYI لحل المشكلة.
رابعاً: استبدال AIHubMix بخدمة APIYI: دليل إعداد banana-slides الكامل
توصي الوثائق الرسمية لـ banana-slides افتراضياً باستخدام AIHubMix كوكيل API (راجع docs.bananaslides.online/configuration#aihubmix-recommended-proxy). ولكن يمكنك استبداله تماماً بـ APIYI (apiyi.com) للاستمتاع بأسعار أفضل، ودعم غير محدود للتزامن، وخطوط ربط محلية أكثر استقراراً.
4.1 لماذا تختار الاستبدال بـ APIYI؟
على الرغم من أن AIHubMix هو الوكيل الموصى به افتراضياً لـ banana-slides، إلا أن APIYI (apiyi.com) يتمتع بعدة مزايا واضحة لمستخدمي banana-slides على المدى الطويل:
| وجه المقارنة | AIHubMix (افتراضي) | APIYI (apiyi.com) (موصى به) |
|---|---|---|
| طرق الدفع | دولار أمريكي / عملة محلية | عملة محلية (WeChat/Alipay) |
| خصومات الأسعار | السعر القياسي | اشحن 100 دولار واحصل على 10% إضافية (خصم حوالي 15%) |
| حدود التزامن | متدرجة حسب الباقة | غير محدود |
| تنسيق API | متوافق مع OpenAI/Gemini | متوافق تماماً مع تنسيقات OpenAI/Gemini/Anthropic الأصلية |
| سهولة الربط | تغيير base_url | تغيير base_url (سهل بنفس القدر) |
| تبديل الفشل | قناة واحدة | موازنة الحمل عبر مراكز بيانات متعددة |
| الدعم الفني | نظام التذاكر | خدمة عملاء باللغة العربية/الصينية + مجموعة WeChat |
4.2 تعديل ملف .env: تنسيق Gemini (موصى به لـ nano banana pro)
يستخدم banana-slides افتراضياً تنسيق Gemini لاستدعاء nano banana pro. افتح ملف .env وابحث عن الإعدادات التالية:
قبل التعديل (إعدادات AIHubMix الافتراضية):
AI_PROVIDER_FORMAT=gemini
GOOGLE_API_KEY=your-aihubmix-key
GOOGLE_API_BASE=https://aihubmix.com/gemini
بعد التعديل (الاستبدال بـ APIYI apiyi.com):
AI_PROVIDER_FORMAT=gemini
GOOGLE_API_KEY=sk-your-apiyi-key-here
GOOGLE_API_BASE=https://vip.apiyi.com/gemini
🎯 ملاحظة هامة: تتوافق خدمة APIYI (apiyi.com) تماماً مع تصميم مسار
base_urlلتنسيق Gemini الأصلي، لذا ما عليك سوى استبدال النطاقaihubmix.comبـvip.apiyi.comمع الحفاظ على المسار/geminiكما هو.
4.3 تعديل ملف .env: تنسيق OpenAI
إذا كنت ترغب في استخدام نماذج سلسلة GPT لتوليد محتوى العرض التقديمي، يمكنك التبديل إلى تنسيق OpenAI:
قبل التعديل:
AI_PROVIDER_FORMAT=openai
OPENAI_API_KEY=your-aihubmix-key
OPENAI_API_BASE=https://aihubmix.com/v1
بعد التعديل (الاستبدال بـ APIYI):
AI_PROVIDER_FORMAT=openai
OPENAI_API_KEY=sk-your-apiyi-key-here
OPENAI_API_BASE=https://vip.apiyi.com/v1
4.4 تعديل ملف .env: تنسيق Anthropic
إذا كنت ترغب في استخدام نماذج Claude لتوليد محتوى عرض تقديمي بجودة أعلى، فإن banana-slides يدعم أيضاً تنسيق Anthropic:
بعد التعديل (الاستبدال بـ APIYI):
AI_PROVIDER_FORMAT=anthropic
ANTHROPIC_API_KEY=sk-your-apiyi-key-here
ANTHROPIC_API_BASE=https://vip.apiyi.com
4.5 الإعداد المختلط: استخدام نماذج مختلفة للنص والصور
يدعم banana-slides استخدام مصادر نماذج مختلفة لتوليد النصوص وتوليد الصور. على سبيل المثال، استخدام Claude Sonnet 4.5 لتوليد النص، وnano banana pro لتوليد الصور:
# توليد النص - استخدام تنسيق Anthropic لاستدعاء Claude
TEXT_MODEL_PROVIDER=anthropic
TEXT_MODEL_NAME=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-your-apiyi-key-here
ANTHROPIC_API_BASE=https://vip.apiyi.com
# توليد الصور - استخدام تنسيق Gemini لاستدعاء nano banana pro
IMAGE_MODEL_PROVIDER=gemini
IMAGE_MODEL_NAME=gemini-2.5-flash-image
GOOGLE_API_KEY=sk-your-apiyi-key-here
GOOGLE_API_BASE=https://vip.apiyi.com/gemini
💡 ميزة هامة: يمكن لمفتاح API واحد من APIYI (apiyi.com) استدعاء جميع النماذج بتنسيقات Gemini وOpenAI وAnthropic في وقت واحد، دون الحاجة لطلب حسابات منفصلة من كل مزود – وهذا تحسن كبير في الراحة مقارنة بالربط المباشر مع المزودين الرسميين.
4.6 إعادة تشغيل الخدمة والتحقق
بعد تعديل ملف .env، أعد تشغيل banana-slides لتفعيل الإعدادات الجديدة:
# نمط Docker Compose
docker compose -f docker-compose.prod.yml down
docker compose -f docker-compose.prod.yml up -d
# نمط المصدر
# أعد تشغيل uv run python app.py
قم بإنشاء عرض تقديمي تجريبي في الواجهة الأمامية، وأدخل جملة: "اصنع لي عرضاً تقديمياً من 5 شرائح حول وكلاء الذكاء الاصطناعي (AI Agent)"، وراقب سجلات الطرفية (Logs):
- ✅ رؤية
Connecting to https://vip.apiyi.com/...تعني أن الطلب يمر عبر وكيل APIYI - ✅ وقت الاستجابة < 30 ثانية (للإنشاء الأولي)
- ✅ عدم وجود أخطاء 429 / 503
4.7 رفع التعديلات إلى الـ Fork الخاص بك (للنشر ضمن فريق)
إذا كنت تنشر ضمن فريق، يمكنك رفع ملف .env.example المعدل إلى الـ Fork الخاص بك (احذر من رفع ملف .env الفعلي الذي يحتوي على مفاتيحك):
# إنشاء قالب إعدادات .env.example.apiyi
cp .env .env.example.apiyi
# قم بتحرير الملف واستبدال مفتاح الـ API الفعلي بـ placeholder
# ثم قم بالرفع
git add .env.example.apiyi
git commit -m "feat: add APIYI (apiyi.com) configuration template"
git push origin main
بهذه الطريقة، يمكن لأعضاء الفريق بعد استنساخ الـ Fork الخاص بك استخدام هذا القالب مباشرة، مما يوفر وقت البحث عن الإعدادات.
خامساً: سيناريوهات عملية لاستخدام banana-slides: 5 حالات تطبيقية نموذجية
5.1 السيناريو الأول: طالب يقوم بإعداد عرض تقديمي (PPT) سريع للفصل الدراسي
الهدف: إكمال عرض تقديمي تعليمي من 10 شرائح في أقل من 30 دقيقة.
خطوات العمل:
- افتح banana-slides واختر وضع "التوليد بجملة واحدة".
- أدخل الموضوع، على سبيل المثال: "شرح مبسط لمبادئ الحوسبة الكمومية".
- سيقوم الذكاء الاصطناعي بتوليد المخطط التفصيلي تلقائياً (حوالي 30 ثانية).
- اضغط على توليد جميع الصفحات (يستغرق 5-8 دقائق، اعتماداً على سرعة توليد الصور).
- استخدم Vibe لتحرير وتعديل بعض الصفحات.
- تصدير الملف بصيغة PPTX.
تقدير استهلاك API: عرض تقديمي من 10 شرائح يستهلك حوالي 50-80 ألف رمز (tokens) للنصوص + 10-15 عملية توليد صور. نوصي باستخدام خدمة وكيل APIYI (apiyi.com) لتجنب قيود السرعة.
5.2 السيناريو الثاني: معلم يحول خطة الدرس إلى عرض تعليمي
الهدف: تحويل خطة درس موجودة بصيغة Word إلى عرض تقديمي تعليمي غني بالصور والنصوص.
خطوات العمل:
- ارفع ملف خطة الدرس بصيغة DOCX.
- سيقوم banana-slides بتحليل هيكل الفصول تلقائياً.
- اختر "توليد الصفحات حسب الفصول".
- سيقوم الذكاء الاصطناعي بتوليد صور توضيحية مطابقة لكل نقطة معرفية.
- تصدير الملف بصيغة MP4 (مع دبلجة صوتية TTS باللغة الصينية)، ليصبح جاهزاً كدرس مسجل.
5.3 السيناريو الثالث: موظف يقوم بإعداد مقترح تجاري
الهدف: توليد عرض تقديمي احترافي لمقترح تجاري بناءً على وصف للمتطلبات.
خطوات العمل:
- اختر "وضع وصف الصفحة" للتحكم الدقيق في محتوى كل شريحة.
- ارفع شعار الشركة وألوان الهوية البصرية كمرجع للقالب.
- استخدم Vibe لتعديل نمط الصور في كل شريحة.
- تصدير الملف بصيغة PPTX قابلة للتعديل لإجراء اللمسات النهائية.
5.4 السيناريو الرابع: مدون تقني يقوم بإعداد عرض تقديمي لإطلاق منتج
الهدف: إعداد عرض تقديمي لإطلاق منتج مكون من 30 شريحة في أقل من 3 ساعات.
خطوات العمل:
- جهز مستند Markdown الخاص بمميزات المنتج.
- ارفعه إلى banana-slides واختر "تقسيم الصفحات حسب H2/H3".
- سيقوم الذكاء الاصطناعي بتوليد صور مرئية مطابقة تلقائياً.
- استخدم صور القالب لضمان اتساق النمط البصري.
- تصدير الملف بصيغتي PDF و PPTX.
5.5 السيناريو الخامس: النشر الخاص (Private Deployment) لاستخدام الفريق
الهدف: نشر banana-slides على الشبكة الداخلية للشركة ليستخدمه الفريق بأكمله.
خطوات العمل:
- قم بعمل Fork للمستودع إلى منظمة GitHub الخاصة بالشركة.
- عدّل إعدادات
.envلربطها بخدمة وكيل APIYI (apiyi.com). - انشر الأداة على خادم داخلي (باستخدام Docker Compose).
- قم بإعداد نطاق داخلي باستخدام Nginx.
- يمكن لأعضاء الفريق الوصول للأداة عبر الشبكة الداخلية.
💡 نصيحة مشتركة للسيناريوهات: تتضمن جميع السيناريوهات الخمسة استدعاءات مكثفة لـ API (كل عرض تقديمي يحتوي على توليد نصوص متعدد + توليد صور متعدد). نوصي بربط banana-slides بخدمة وكيل APIYI (apiyi.com) للاستفادة من ميزة عدم وجود قيود على التزامن، مما يضمن عدم تأثر سرعة توليد العروض التقديمية بقيود الواجهات الرسمية.
سادساً: الأسئلة الشائعة حول banana-slides
س1: ما الفرق بين banana-slides وأدوات الذكاء الاصطناعي الأخرى (مثل Gamma أو MindStudio)؟
الفرق الجوهري هو المصدر المفتوح وقابلية التخصيص. الأدوات التجارية مثل Gamma هي خدمات سحابية (SaaS) تعتمد على الاشتراك الشهري أو الدفع لكل صفحة؛ بينما banana-slides هو مشروع مفتوح المصدر (رخصة AGPL-3.0)، يمكنك نشره محلياً، وتعديل الكود المصدري بحرية، والربط مع أي نموذج ذكاء اصطناعي.
إذا كنت تستخدم العروض التقديمية بشكل متقطع، فقد تكون Gamma أسهل، ولكن إذا كنت تحتاج إلى:
- نشر خاص للفريق.
- التحكم في تكاليف API.
- تعديل منطق التوليد.
- استخدام API يمكن الوصول إليه محلياً.
فإن banana-slides هو الخيار الأفضل، ومع خدمة وكيل APIYI (apiyi.com) يمكنك تحقيق سيطرة كاملة ومستقلة.
س2: ليس لدي مفتاح Google API، هل يجب أن أطلب Gemini لاستخدام banana-slides؟
لا. يدعم banana-slides ثلاثة تنسيقات لـ API (Gemini / OpenAI / Anthropic)، وتحتاج فقط إلى مفتاح من أي مزود لتشغيله.
أسهل طريقة هي التسجيل في APIYI (apiyi.com)، حيث يمكنك بمفتاح واحد استدعاء Gemini (بما في ذلك nano banana pro لتوليد الصور)، وGPT، وClaude، مما يوفر عليك عناء التقديم لكل خدمة على حدة.
س3: هل ستتأثر الوظائف الأصلية عند استبدال AIHubMix بـ APIYI؟
لن تتأثر على الإطلاق. يستخدم banana-slides متغيرات البيئة GOOGLE_API_BASE و OPENAI_API_BASE لتحديد عنوان استدعاء API. طالما أن المزود متوافق مع بروتوكولات API (وAPIYI متوافق تماماً مع التنسيقات الأصلية لـ Gemini وOpenAI وAnthropic)، فستعمل جميع الوظائف بشكل طبيعي، بما في ذلك توليد الصور، والدبلجة الصوتية TTS، وتحرير Vibe.
س4: ما هو اسم نموذج nano banana pro على APIYI؟
معرف النموذج الرسمي لـ nano banana pro على APIYI (apiyi.com) هو gemini-2.5-flash-image (التسمية الرسمية من Google). يمكنك ضبطه في ملف .env الخاص بـ banana-slides كالتالي:
IMAGE_MODEL_NAME=gemini-2.5-flash-image
GOOGLE_API_BASE=https://vip.apiyi.com/gemini
س5: كم تبلغ تكلفة API لعرض تقديمي من 30 شريحة؟
التقدير كالتالي:
- توليد النصوص (المخطط + المحتوى): حوالي 100-200 ألف رمز (tokens).
- توليد الصور (1-2 صورة لكل شريحة): حوالي 30-60 استدعاء.
- التكلفة الإجمالية: بعد خصم 10% عند الشحن عبر APIYI (apiyi.com)، تبلغ حوالي 1-3 دولارات.
س6: هل سيحدث بطء عند استخدام الأداة من قبل عدة أشخاص بعد نشرها على خادم الشركة؟
عنق الزجاجة الرئيسي هو تزامن API. يعتمد banana-slides على بنية Flask + SQLite، ويمكن للجهاز الواحد تحمل 10-20 مستخدماً في وقت واحد. غالباً ما تظهر المشكلة في طبقة استدعاء API؛ إذا استخدمت الواجهات الرسمية، فستواجه قيوداً على السرعة، بينما يتيح لك وكيل APIYI (apiyi.com) ميزة عدم وجود قيود على التزامن، مما يمنع حدوث اختناقات.
س7: هل يتطلب الاستخدام التجاري لـ banana-slides دفع رسوم؟
نعم. يستخدم banana-slides رخصة AGPL-3.0، وهو مجاني للاستخدام الشخصي وغير التجاري. أما في حالة النشر التجاري، فيجب التواصل مع المؤلف لشراء ترخيص تجاري (البريد الإلكتروني: [email protected]). حتى مع الترخيص التجاري، يمكنك الاستمرار في استخدام وكيل APIYI (apiyi.com) لجزء الـ API، ولا يوجد تعارض بينهما.
س8: كيف يمكنني متابعة تحديثات banana-slides؟
بما أنك قمت بعمل Fork للمستودع، يمكنك مزامنة التحديثات دورياً كالتالي:
# إضافة المستودع الأصلي
git remote add upstream https://github.com/Anionex/banana-slides.git
# سحب التحديثات
git fetch upstream
git checkout main
git merge upstream/main
# الدفع إلى الـ Fork الخاص بك
git push origin main
تأكد من الاحتفاظ بإعدادات .env الخاصة بك لتجنب استبدالها.
سابعاً: النقاط الجوهرية لـ banana-slides
- ✅ banana-slides هو مولد عروض تقديمية (PPT) مفتوح المصدر يعمل بالذكاء الاصطناعي، يعتمد على نموذج الصور nano banana pro، ويحظى بأكثر من 14 ألف نجمة على GitHub.
- ✅ يدعم طرق إدخال متعددة: جملة واحدة، مخطط تفصيلي، وصف للصفحات، أو رفع ملفات بصيغ PDF/DOCX/MD/TXT.
- ✅ ثلاث صيغ للتصدير: ملفات PPTX قابلة للتعديل، ملفات PDF، ومقاطع فيديو MP4 (مع ميزة تحويل النص إلى كلام TTS).
- ✅ 3 خطوات للنشر: Fork للمستودع ← نسخ ملف الإعدادات
cp .env.example .env← تشغيلdocker compose up. - ✅ يدعم 3 صيغ API: Gemini (افتراضي)، OpenAI، وAnthropic.
- ✅ استبدال AIHubMix بـ APIYI يتطلب فقط تغيير
base_url: قم بتغيير الرابط منaihubmix.comإلىvip.apiyi.com. - ✅ مزايا APIYI (apiyi.com): توافق أصلي مع الصيغ، لا قيود على التزامن (Concurrency)، عرض خاص (اشحن 100 دولار واحصل على 10% إضافية، أي ما يعادل خصم 15%)، ودعم الدفع بالعملة المحلية (اليوان).
- ✅ مفتاح API واحد للجميع: توافق كامل مع صيغ Gemini/OpenAI/Anthropic.
ثامناً: الخلاصة
يُعد banana-slides مولد عروض تقديمية مفتوح المصدر يستحق المتابعة على المدى الطويل، حيث يجمع بين قدرات توليد الصور في نموذج nano banana pro ونموذج التفاعل "Vibe Editing"، مما يتيح للمستخدمين العاديين إنشاء عروض تقديمية احترافية في أقل من 30 دقيقة.
بالنسبة للمطورين الذين قرروا إجراء Fork للمشروع ونشره، تُعد خطوة إعداد مزود خدمة الـ API هي الأكثر أهمية. ورغم أن الخدمة الافتراضية الموصى بها رسمياً AIHubMix تعمل بشكل جيد، إلا أن الانتقال إلى APIYI (apiyi.com) يوفر مزايا واضحة: توافق تام مع صيغ Gemini/OpenAI/Anthropic (دون الحاجة لتعديل أي كود برمجي)، عدم وجود قيود على التزامن (مما يمنع توقف الخدمة عند العمل على عروض كبيرة أو من قبل عدة مستخدمين)، ميزة التكلفة (خصم 15% عند شحن 100 دولار)، وتسهيلات الدفع المحلي (عبر WeChat/Alipay).
عملية الاستبدال بسيطة للغاية؛ ما عليك سوى تغيير GOOGLE_API_BASE (أو OPENAI_API_BASE أو ANTHROPIC_API_BASE) في ملف .env من https://aihubmix.com/... إلى https://vip.apiyi.com/... ثم إدخال مفتاح API الخاص بك من APIYI.
إذا كنت تفكر في بناء نظام لإنشاء العروض التقديمية بالذكاء الاصطناعي لفريق عمل، أو ترغب في توفير أداة PPT سهلة الاستخدام لنفسك أو لطلابك، فإن الجمع بين banana-slides وAPIYI (apiyi.com) هو الخيار الأكثر ملاءمة للمطورين حالياً. ابدأ اليوم بعمل Fork للمشروع، وستتمكن من تشغيل أول عرض تقديمي مولد بالذكاء الاصطناعي في أقل من ساعة.
🎯 اقتراح للخطوة التالية: قم بزيارة APIYI (apiyi.com) لتسجيل حساب والحصول على مفتاح API، ثم قم بعمل Fork لمستودع
github.com/Anionex/banana-slidesإلى حسابك على GitHub، واتبع طريقة الإعداد المذكورة في الفصل الرابع من هذا المقال لتعديل ملف.env. بعد تشغيل الخدمة، استخدم موجه (prompt) بسيط لتوليد أول عرض تقديمي لك والتحقق من سير العمل.
مراجع إضافية
-
مستودع banana-slides على GitHub: المستودع الرئيسي للمشروع
- الرابط:
github.com/Anionex/banana-slides - الوصف: يحتوي على الكود المصدري الكامل، إعدادات Docker Compose، وملف README باللغة الإنجليزية.
- الرابط:
-
التوثيق الرسمي لـ banana-slides: دليل الإعداد والنشر
- الرابط:
docs.bananaslides.online/configuration - الوصف: يتضمن قسماً خاصاً بالوكلاء الموصى بهم من AIHubMix، بينما يعلمك هذا المقال كيفية استبدالهم بـ APIYI.
- الرابط:
-
شرح نموذج nano banana pro: نموذج توليد الصور الرسمي من Google
- الرابط:
ai.google.dev/gemini-api/docs/image-generation - الوصف: معرف النموذج هو
gemini-2.5-flash-image.
- الرابط:
-
الموقع الرسمي لـ APIYI: منصة خدمة وكيل API لنماذج Claude / Gemini / OpenAI
- الرابط:
apiyi.com - الوصف: توافق مع التنسيقات الأصلية، لا قيود على التزامن، دعم الدفع بالعملة الصينية (RMB)، احصل على مكافأة 10% عند شحن 100 دولار.
- الرابط:
المؤلف: الفريق التقني
آخر تحديث: 2026-05-01
نبذة عن APIYI: تُعد APIYI (apiyi.com) مزوداً احترافياً لخدمات وكيل API لنماذج اللغة الكبيرة، حيث توفر وصولاً مستقراً لمجموعة كاملة من النماذج مثل Gemini (بما في ذلك nano banana pro)، وClaude Sonnet 4.5، وClaude Opus 4.7، وسلسلة GPT. تتوافق المنصة تماماً مع التنسيقات الأصلية لـ Gemini/OpenAI/Anthropic، وتوفر مكافأة 10% عند شحن 100 دولار (ما يعادل خصم 15% مقارنة بالموقع الرسمي)، مع عدم وجود قيود على التزامن ودعم فني سريع الاستجابة.
