metadata
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
{ "poem": "ููุง ูุจู ู
ู ุฐูุฑู ุญุจูุจ ูู
ูุฒู..." }
/fasserha โ Response
{
"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
{ "idea": "ุงูุดูู ุฅูู ุงููุทู", "meter": "ุงูุทููู", "num_verses": 4 }
Environment Variables
Set OPENAI_API_KEY in the Space secrets.