README.md

---
title: Bayan API
emoji: 📜
colorFrom: indigo
colorTo: purple
sdk: docker
pinned: false
---

# Bayan API — مشروع بيان

FastAPI backend for the Bayan Arabic Poetry AI project.

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/health` | Health check |
| POST | `/fasserha` | فسّرها لي — classify + literary analysis |
| POST | `/generate` | ساعدني في الكتابة — generate verses |
| GET | `/meters` | List all supported meters |

## /fasserha — Request
```json
{ "poem": "قفا نبك من ذكرى حبيب ومنزل..." }
```

## /fasserha — Response
```json
{
  "success": true,
  "data": {
    "meter": { "meter_ar": "الطويل", "meter_en": "taweel", "confidence": 0.95 },
    "era":   { "era": "قديم", "classical_probability": 0.98, "modern_probability": 0.02 },
    "topic": { "topic": "غزل رومانسي", "confidence": 0.87, "top3": [...] },
    "explanation": "..."
  }
}
```

## /generate — Request
```json
{ "idea": "الشوق إلى الوطن", "meter": "الطويل", "num_verses": 4 }
```

## Environment Variables
Set `OPENAI_API_KEY` in the Space secrets.