---
title: Rawi Arabic AI Storytelling
emoji: 📚
colorFrom: blue
colorTo: indigo
sdk: docker
app_file: app.py
pinned: false
---

# رَاوي (Rawi) - منصة القص العربي بالذكاء الاصطناعي 

## نظرة عامة
خدمة API لتوليد قصص عربية تفاعلية باستخدام الذكاء الاصطناعي. تتيح المنصة للمستخدمين إنشاء قصص مخصصة بناءً على معلمات محددة، والتفاعل مع القصة من خلال خيارات متعددة، والاستماع إلى القصص المنشأة بتقنية تحويل النص إلى كلام.

## المميزات
- إنشاء قصص عربية أصلية باستخدام نماذج الذكاء الاصطناعي من DeepSeek
- تخصيص معلمات القصة مثل الطول والنوع والشخصيات
- القص التفاعلي مع خيارات متعددة للمسارات
- تحويل النص إلى صوت عربي
- واجهة برمجة تطبيقات RESTful متكاملة

## واجهة برمجة التطبيقات (API)

### تهيئة قصة جديدة
```
POST /api/stories/initialize
```

### متابعة القصة
```
POST /api/stories/continue
```

### تحويل القصة إلى صوت
```
POST /api/stories/tts
```

### تعديل القصة
```
POST /api/stories/edit
```

### الحصول على القصة كاملة
```
GET /api/stories/story/{story_id}
```

### الوصول إلى الملفات الصوتية
```
GET /audio/{filename}
```

## فحص الحالة والمعلومات
```
GET /health
```

## المتطلبات البيئية
- `DEEPSEEK_API_KEY`: مفتاح API للوصول إلى نماذج DeepSeek
- `BACKEND_HOST`: مضيف الخادم (افتراضي: 0.0.0.0)
- `BACKEND_PORT`: منفذ الخادم (افتراضي: 7860)
- `BASE_URL`: عنوان URL الأساسي للخدمة
- `AUDIO_STORAGE_PATH`: مسار تخزين الملفات الصوتية (افتراضي: ./audio_files)

## التكامل مع التطبيقات
تم تصميم هذه الخدمة للعمل مع:
1. واجهة المستخدم الويب لـراوي
2. تطبيق Flutter للأجهزة المحمولة

## توثيق واجهة برمجة التطبيقات
يمكن الوصول إلى وثائق API التفاعلية الكاملة عبر:
```
https://[your-space-name].hf.space/docs
```