README.md

---
title: MMS ProxyAPI
emoji: 🎤
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# MMS Speech-to-Text API

REST API built with FastAPI using the `facebook/mms-1b-all` model — supports 1000+ languages including Twi.

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/` | API info |
| GET | `/health` | Health check |
| POST | `/transcribe` | Transcribe audio file |

## Usage

```bash
curl -X POST "https://fredyhoundayi-mms-proxyapi.hf.space/transcribe" \
  -F "file=@audio.mp3" \
  -F "language=twi"
```

### Response

```json
{
  "transcription": "awaci ciri duya bi hon",
  "language": "twi"
}
```

## Supported languages

Pass any MMS language code via the `language` field (default: `twi`).
Full list: https://dl.fbaipublicfiles.com/mms/misc/language_coverage_mms.html