أتمته API لعمل فيديوهات بشكل تلقائي

# AI Video Factory System Requirements

## الهدف

إنشاء نظام محلي (Local System) يعمل على جهاز الكمبيوتر ويقوم بإنتاج فيديوهات يوتيوب بشكل شبه أوتوماتيكي أو أوتوماتيكي بالكامل من البداية للنهاية، مع دعم عدة قنوات وعدة Niches مختلفة.

---

# Supported Niches

يجب أن يدعم النظام إضافة عدد غير محدود من الـ Niches مثل:

* True Crime

* Horror

* Facts

* History

* Mystery

* Reddit Stories

* Motivation

* AI News

* Luxury

* Gaming

* Any Custom Niche

يجب أن يكون من السهل إضافة Niche جديدة من خلال واجهه المستخدم اضافة او تعديل او حذف نيتش مستقبلاً دون تعديل كبير في النظام.

---

# Main Workflow

## 1. Topic Generation

* توليد أفكار جديدة لكل Niche.

* إمكانية إدخال Topic يدويًا.

* إمكانية استخدام Topics مخزنة مسبقًا.

يتم في البدايه اختيار النيتش و بعد كدا اختيار الفديو قصير او طويل في حال قصير يكون الفديو بالطول و في حالة طويل يكون الفديو بالعرض

---

## 2. Script Generation

استخدام AI لإنشاء سكربت احترافي.

متطلبات السكربت:

* Hook قوي في البداية.

* أسلوب مناسب لكل Niche.

* الحفاظ على Retention عالي.

* دعم Shorts و Long Form.

* دعم أكثر من لغة.

مع امكانيه اختيار عدد الكلمات للسكربت

---

## 3. Scene Extraction

بعد إنشاء السكربت:

* تقسيم السكربت إلى مشاهد.

* استخراج Keywords لكل مشهد.

* استخراج Keywords بديلة لكل مشهد.

مثال:

Scene:

"A prisoner escaped through an underground tunnel"

Keywords:

* prison escape

* tunnel

* underground

* dark hallway

* running man

---

## 4. Video Search Engine

البحث عن فيديوهات تلقائياً.

مصادر البحث:

* Pexels API

* Pixabay API

* Local Assets Database

---

## 5. Smart Fallback System

إذا لم يتم العثور على فيديو مناسب:

Level 1:

Search باستخدام الكلمات الأساسية.

Level 2:

Search باستخدام كلمات مرتبطة.

Level 3:

Search باستخدام كلمات عامة مرتبطة بالمشهد.

Level 4:

استخدام مكتبة الفيديوهات المحلية.

Level 5:

استخدام صور ثابتة مع حركة Zoom.

Level 6:

استخدام Placeholder Footage.

يجب ألا يتوقف إنشاء الفيديو بسبب عدم العثور على فيديو مناسب.

---

## 6. Local Media Library

إنشاء مكتبة محلية:

/assets/crime

/assets/horror

/assets/facts

/assets/history

/assets/reddit

/assets/gaming

/assets/general

يقوم النظام بإعادة استخدام المواد الموجودة عند الحاجة.

---

## 7. Voice Generation

استخدام ElevenLabs API.

المطلوب:

إنشاء Voice Manager.

إذا انتهى الرصيد أو فشل حساب:

Account 1

↓

Account 2

↓

Account 3

↓

...

↓

Account 100

يجب أن ينتقل النظام تلقائياً للحساب التالي دون تدخل يدوي.

يجب حفظ حالة كل API Key. مع امكانيه تعديلهم من خلال الواجه

في حالة:

* انتهاء الكريدت

* Rate Limit

* Error

يتم استخدام الحساب التالي تلقائياً.

---

## 8. Subtitle Generation

إنشاء Subtitles تلقائياً.

دعم:

* Arabic

* English

* German

* أي لغة أخرى مستقبلاً

---

## 9. Video Editing Engine

باستخدام:

* MoviePy

* FFmpeg

المطلوب:

* قص الفيديوهات تلقائياً.

* ترتيب المشاهد.

* إضافة الصوت.

* إضافة Subtitles.

* إضافة Background Music. تكون مناسبه للفديو

* إضافة Zoom Effects.

* إضافة Transitions.

* تصدير الفيديو النهائي.

---

## 10. Thumbnail Generator

إنشاء Thumbnail تلقائياً.

يدعم:

* AI Generated Thumbnail

أو

* Template Based Thumbnail

---

يتم حفظ الفديو باسمو فيالفايل الخاص بنوع النيتش مثلا جريمه او طبي و هكذا و معه الصورة المصغرة

-

---

## 11. Project Database

تخزين:

* Topics المستخدمة.

* Scripts.

* Video Assets.

* Uploaded Videos.

* Channel Statistics.

* API Status.

---

## 12. Logging System

تسجيل جميع العمليات:

* Script Generated

* Voice Generated

* Video Created

* Upload Completed

* Upload Failed

* API Switched

---

## 13. Dashboard

واجهة بسيطة لإدارة النظام.

تحتوي على:

* Niches

* Channels

* API Status

* Upload Queue

* Generated Videos

* Logs

---

## 14. Modular Architecture

يجب تقسيم النظام إلى Modules مستقلة:

script_engine.py

topic_engine.py

scene_engine.py

video_search_engine.py

voice_engine.py

subtitle_engine.py

thumbnail_engine.py

editor_engine.py

upload_engine.py

scheduler.py

database.py

dashboard.py

---

# Future Expansion

يجب بناء النظام بحيث يمكن إضافة:

* TikTok Upload

* Facebook Reels Upload

* Instagram Reels Upload

* AI Image Generation

* AI Video Generation

* Trend Discovery

* Analytics System

بدون الحاجة لإعادة بناء النظام بالكامل.

يكون بلغه بايثون