---
title: SuperTonic3 TTS API
emoji: 🎤
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# SuperTonic3 TTS API

OpenAI-compatible Text-to-Speech API server powered by [supertonic3](https://github.com/nicegram/nicegram-android) (ONNX-based). Drop-in replacement for OpenAI's TTS API with 31 languages and 10 built-in voices.

**Key Features:**

- **OpenAI API Compatible** - Works with any OpenAI TTS client
- **31 Languages** - Single model supports 31 languages
- **10 Built-in Voices** - M1-M5 (male), F1-F5 (female)
- **CPU Optimized** - No GPU required (ONNX runtime)
- **44100 Hz Output** - High-quality audio
- **Docker Ready** - One-command deployment

## Quick Start

### Docker

```bash
docker compose up -d
```

Server available at `http://localhost:7860`

### Python

```bash
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python server.py
```

## API Usage

### Generate Speech

```bash
curl -X POST http://localhost:7860/v1/audio/speech \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1",
    "input": "Hello world!",
    "voice": "M1"
  }' \
  --output speech.mp3
```

### Python Client

```python
from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:7860/v1",
    api_key="not-needed"
)

response = client.audio.speech.create(
    model="tts-1",
    voice="M1",
    input="Hello world!"
)
response.stream_to_file("output.mp3")
```

### Speech Parameters

| Parameter         | Type    | Required | Default | Description                       |
| ----------------- | ------- | -------- | ------- | --------------------------------- |
| `input`           | string  | Yes      | -       | Text to synthesize                |
| `voice`           | string  | No       | `M1`    | Voice: M1-M5, F1-F5              |
| `response_format` | string  | No       | `mp3`   | Output: `mp3`, `wav`, `flac`     |
| `lang`            | string  | No       | `en`    | Language code (31 supported)      |
| `stream`          | boolean | No       | `false` | Enable streaming                  |

### Languages

31 supported languages: en, zh, ja, ko, fr, de, es, it, pt, ru, ar, hi, bn, id, ms, th, vi, tl, tr, fa, pl, nl, sv, da, fi, cs, ro, hu, el, he, uk

## Configuration

| Environment Variable                | Default    | Description       |
| ----------------------------------- | ---------- | ----------------- |
| `SUPERTONIC3_HOST`                  | `0.0.0.0`  | Bind address      |
| `SUPERTONIC3_PORT`                  | `7860`     | Port              |
| `SUPERTONIC3_VOICE`                 | `M1`       | Default voice     |
| `SUPERTONIC3_LOG_LEVEL`             | `INFO`     | Log level         |