File size: 1,173 Bytes
0d2b1e7
5f56b43
 
 
 
 
0d2b1e7
 
 
5f56b43
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
---
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.