README.md

---
title: Smart Quiz API
emoji: "🧠"
colorFrom: "blue"
colorTo: "green"
sdk: "docker"
app_file: "app.py"
pinned: false
---

# Smart Quiz API

This is the **FastAPI backend** for the Smart Quiz system. It provides an API endpoint to generate AI-powered multiple-choice quiz questions based on a given topic.

> 👉 To try the full interactive quiz experience, please visit the Gradio UI:  
> <a href="https://gface.co/spaces/NZLouislu/smart-quiz-ui" target="_blank" rel="noopener noreferrer">NZLouislu/smart-quiz-ui</a>

---

## 🧠 API Endpoint

**POST** `/generate_quiz`

### Request Body (JSON)

```json
{
  "topic": "New Zealand",
  "n_questions": 3,
  "difficulty": "medium"
}