---
title: Media Gen Api
emoji: 📊
colorFrom: indigo
colorTo: pink
sdk: docker
pinned: false
short_description: FastAPI backend for Text-to-Audio, Image, and Video generato
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
=======
# 🎙️ Media Generation API

A FastAPI-based backend to generate audio, images, video, and PPT from user inputs. 
Supports BLEU/CLIP metrics, token-based authentication, and stores metadata in SQLite/Postgres.

A modular, RESTful FastAPI solution that converts text input into:
- 🎥 Video
- 🖼️ Image/Graphics
- 🔊 Audio


---

## 🚀 Features

- Text → Video: Tone, domain, and environment-aware video generation.
- Text → Audio: Context-aware voice synthesis with emotional tone and language support.
- Text → Graphics: Visual generation using parameter-based prompts.
- BLEU/CLIP metrics for prompt-output fidelity.
- Token-based authentication for secure API use.
- Dockerized for easy deployment
- Optional Streamlit/React UI
- Swagger UI: `http://localhost:8000/docs`

---

### 📁 Project Structure
media-gen-api/
├── app/
│   ├── api/v1/               # Versioned API endpoints
│   ├── auth/                 # Token-based auth
│   ├── services/             # Core media generation logic
│   └── main.py               # FastAPI entry point
├── tests/                    # Unit/integration tests
├── requirements.txt
└── README.md

---

## 📦 Installation
🚀 Run Locally
1. Clone repo & create virtual environment

git clone https://github.com/yourorg/media-gen-api.git
cd media-gen-api
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies

pip install -r requirements.txt

3. Run the API

uvicorn app.main:app --reload

Access docs: http://127.0.0.1:8000/docs

---
### 🔐 Authentication
Use Bearer <your_token> in the Authorize button or headers.

---
### 📡 API Endpoints Summary
| Endpoint                  | Method | Description               |
|--------------------------|--------|---------------------------|
| /api/v1/audio/generate   | POST   | Generate audio from text |
| /api/v1/image/generate   | POST   | Generate image from text |
| /api/v1/video/generate   | POST   | Generate video from text |
| /api/v1/download         | GET    | Download generated file  |

---
###📦 Deployment (Streamlit/Optional UI)
Option 1: Run with Streamlit (for demo)
streamlit run streamlit_ui.py

Option 2: Docker (Production-ready)
docker build -t media-gen-api .
docker run -p 8000:8000 media-gen-api

---
### 📊 Metrics Logging (Optional)
- BLEU score and CLIPScore (WIP)
- Latency, GPU/CPU tracking
- Log file: logs/generation.log

---
#### 📋 Submission Checklist
- ✅ RESTful modular architecture
- ✅ Multi-format (MP4, PNG, WAV)
- ✅ Token Auth + Swagger UI
- ✅ Compatible with DD/PIB via API
- ✅ Streamlit demo app (optional)