# Qwen3-TTS-API

Qwen3-TTS-API is a self-hosted ai app. OpenAI-compatible Text-to-Speech API powered by Qwen3-TTS with CUDA graph acceleration, delivering 7-10x faster inference across 10 languages with 9 built-in voices, voice cloning, emotion control, and streaming WAV... It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3249/qwen3-tts-api

## Description

OpenAI-compatible Text-to-Speech API powered by Qwen3-TTS with CUDA graph acceleration, delivering 7-10x faster inference across 10 languages with 9 built-in voices, voice cloning, emotion control, and streaming WAV output. Requires an NVIDIA GPU (RTX 4060 / 5060 Ti class or newer) with driver 550+.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

41/100 (Fair), based on 4 of 4 factors.
- Maintained: 59 (last commit 165 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (1.09961 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/qwen3-tts-api-0vbtr2o1t6jsv0?q=Qwen3-TTS-API

## Common questions

### How do I deploy Qwen3-TTS-API with Docker?

Run the container with GPU access, map port 8080, mount the model cache at /root/.cache/huggingface, and set --shm-size=4g. A Docker Compose file is also provided in the repo's docker/gpu directory.

### Which endpoint do I call for standard text-to-speech?

Use the OpenAI-compatible /v1/audio/speech endpoint with a JSON body containing input and voice, with optional language, instruct, or stream parameters.

### How do I use voice cloning?

Use the /v1/audio/speech/clone endpoint. The README says voice cloning is supported from 3-second reference audio.

### How do I control emotion in the generated speech?

Emotion control is available only with the 1.7B CustomVoice model. Send an instruct field in the /v1/audio/speech request.

### How should China-based users handle model downloads?

Set the HF_ENDPOINT environment variable to the HuggingFace mirror for China.

---
Source: Our Local Host (https://ourlocalhost.com/app/3249/qwen3-tts-api), the self-hosted and open-source app directory.
