Text-to-Audio
Diffusers
Safetensors
English
Chinese
MossSoundEffectPipeline
diffusion
flow-matching
sound-effects
audio-generation
Instructions to use OpenMOSS-Team/MOSS-SoundEffect-v2.0 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use OpenMOSS-Team/MOSS-SoundEffect-v2.0 with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("OpenMOSS-Team/MOSS-SoundEffect-v2.0", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
Upload README.md with huggingface_hub
Browse files
README.md
CHANGED
|
@@ -14,69 +14,32 @@ tags:
|
|
| 14 |
- sound-effects
|
| 15 |
- audio-generation
|
| 16 |
---
|
| 17 |
-
# MOSS-TTS Family
|
| 18 |
|
| 19 |
-
|
| 20 |
-
<br>
|
| 21 |
|
| 22 |
<p align="center">
|
| 23 |
-
|
| 24 |
<img src="https://speech-demo.oss-cn-shanghai.aliyuncs.com/moss_tts_demo/tts_readme_imgaes_demo/openmoss_x_mosi" height="50" align="middle" />
|
| 25 |
</p>
|
| 26 |
|
| 27 |
-
|
| 28 |
-
|
| 29 |
<div align="center">
|
| 30 |
-
<a href="https://github.com/OpenMOSS/MOSS-TTS/tree/main"><img src="https://img.shields.io/badge/Project%20Page-GitHub-blue"></a>
|
| 31 |
-
<a href="https://modelscope.cn/collections/OpenMOSS-Team/MOSS-TTS"><img src="https://img.shields.io/badge/ModelScope-Models-lightgrey?logo=modelscope&"></a>
|
| 32 |
-
<a href="https://mosi.cn/#models"><img src="https://img.shields.io/badge/Blog-View-blue?logo=internet-explorer&"></a>
|
| 33 |
-
<a href="https://arxiv.org/abs/2603.18090"><img src="https://img.shields.io/badge/Arxiv-2603.18090-red?logo=Arxiv&"></a>
|
| 34 |
-
|
| 35 |
-
<a href="https://studio.mosi.cn"><img src="https://img.shields.io/badge/AIStudio-Try-green?logo=internet-explorer&"></a>
|
| 36 |
-
<a href="https://studio.mosi.cn/docs/moss-tts"><img src="https://img.shields.io/badge/API-Docs-00A3FF?logo=fastapi&"></a>
|
| 37 |
-
<a href="https://x.com/Open_MOSS"><img src="https://img.shields.io/badge/Twitter-Follow-black?logo=x&"></a>
|
| 38 |
-
<a href="https://discord.gg/fvm5TaWjU3"><img src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&"></a>
|
| 39 |
</div>
|
| 40 |
|
| 41 |
-
|
| 42 |
-
## Overview
|
| 43 |
-
MOSS‑TTS Family is an open‑source **speech and sound generation model family** from [MOSI.AI](https://mosi.cn/#hero) and the [OpenMOSS team](https://www.open-moss.com/). It is designed for **high‑fidelity**, **high‑expressiveness**, and **complex real‑world scenarios**, covering stable long‑form speech, multi‑speaker dialogue, voice/character design, environmental sound effects, and real‑time streaming TTS.
|
| 44 |
-
|
| 45 |
-
|
| 46 |
-
## Introduction
|
| 47 |
-
|
| 48 |
-
<p align="center">
|
| 49 |
-
<img src="https://speech-demo.oss-cn-shanghai.aliyuncs.com/moss_tts_demo/tts_readme_imgaes_demo/moss_tts_family_arch.jpeg" width="85%" />
|
| 50 |
-
</p>
|
| 51 |
-
|
| 52 |
-
|
| 53 |
-
When a single piece of audio needs to **sound like a real person**, **pronounce every word accurately**, **switch speaking styles across content**, **remain stable over tens of minutes**, and **support dialogue, role‑play, and real‑time interaction**, a single TTS model is often not enough. The **MOSS‑TTS Family** breaks the workflow into five production‑ready models that can be used independently or composed into a complete pipeline.
|
| 54 |
-
|
| 55 |
-
- **MOSS‑TTS**: The flagship production model featuring high fidelity and optimal zero-shot voice cloning. It supports **long-speech generation**, **fine-grained control over Pinyin, phonemes, and duration**, as well as **multilingual/code-switched synthesis**.
|
| 56 |
-
- **MOSS‑TTSD**: A spoken dialogue generation model for expressive, multi-speaker, and ultra-long dialogues. The new **v1.0 version** achieves **industry-leading performance on objective metrics** and **outperformed top closed-source models like Doubao and Gemini 2.5-pro** in subjective evaluations. You can visit the [MOSS-TTSD repository](https://github.com/OpenMOSS/MOSS-TTSD) for details.
|
| 57 |
-
- **MOSS‑VoiceGenerator**: An open-source voice design model capable of generating diverse voices and styles directly from text prompts, **without any reference speech**. It unifies voice design, style control, and synthesis, functioning independently or as a design layer for downstream TTS. Its performance **surpasses other top-tier voice design models in arena ratings**.
|
| 58 |
-
- **MOSS‑TTS‑Realtime**: A multi-turn context-aware model for real-time voice agents. It uses incremental synthesis to ensure natural and coherent replies, making it **ideal for building low-latency voice agents when paired with text models**. The TTFB (Time To First Byte) of MOSS-TTS-Realtime reaches 180 ms, and the $T_{\text{LLM-first-sentence}} + T_{\text{MOSS-TTS-Realtime-TTFB}}$ is 377 ms.
|
| 59 |
-
- **MOSS‑SoundEffect**: A content creation model specialized in **sound effect generation** with wide category coverage and controllable duration. It generates audio for natural environments, urban scenes, biological sounds, human actions, and musical fragments, suitable for film, games, and interactive experiences.
|
| 60 |
-
|
| 61 |
-
---
|
| 62 |
-
|
| 63 |
-
## MOSS-SoundEffect-V2.0
|
| 64 |
-
|
| 65 |
**MOSS-SoundEffect v2.0** is a text-to-audio model with a Diffusion Transformer (DiT) backbone trained with the Flow Matching objective, paired with a DAC VAE and a Qwen3 text encoder. It generates high-fidelity environmental, urban, creature, and human-action sound effects from natural-language prompts, with controllable duration up to 30 seconds at 48 kHz.
|
| 66 |
|
| 67 |
-
##
|
| 68 |
|
| 69 |
-
###
|
| 70 |
|
| 71 |
Within the MOSS-TTS Family, MOSS-SoundEffect is the dedicated **text-to-sound** model — the family member that turns natural-language captions into non-speech audio (ambience, urban scenes, creatures, human actions, short music-like clips). v2.0 supersedes the v1 discrete-token autoregressive backbone (`MossTTSDelay`) with a continuous-latent **Diffusion Transformer + Flow Matching** design.
|
| 72 |
|
| 73 |
-
###
|
| 74 |
|
| 75 |
- **Broad SFX coverage**: natural environments, urban environments, animals & creatures, human actions, and short musical/percussive clips.
|
| 76 |
- **Long-form generation**: stable audio up to **30 seconds** per call with the duration tag prepended to the prompt at training time.
|
| 77 |
- **Bilingual prompts**: trained with both **English and Chinese** captions.
|
| 78 |
|
| 79 |
-
###
|
| 80 |
|
| 81 |
| Model | Architecture | DiT Variant | Parameters |
|
| 82 |
|---|---|---|---:|
|
|
@@ -91,9 +54,9 @@ Within the MOSS-TTS Family, MOSS-SoundEffect is the dedicated **text-to-sound**
|
|
| 91 |
| `sigma_shift` | 5.0 | Flow-match scheduler shift applied per call. |
|
| 92 |
| `seconds` | 10.0 | Output duration. Up to 30. |
|
| 93 |
|
| 94 |
-
##
|
| 95 |
|
| 96 |
-
###
|
| 97 |
|
| 98 |
We recommend a clean, isolated Python 3.12 environment to avoid dependency conflicts with the top-level MOSS-TTS environment.
|
| 99 |
|
|
@@ -114,7 +77,7 @@ pip install --extra-index-url https://download.pytorch.org/whl/cu128 \
|
|
| 114 |
-e ".[torch-cu128]"
|
| 115 |
```
|
| 116 |
|
| 117 |
-
###
|
| 118 |
|
| 119 |
```python
|
| 120 |
import torch
|
|
|
|
| 14 |
- sound-effects
|
| 15 |
- audio-generation
|
| 16 |
---
|
|
|
|
| 17 |
|
| 18 |
+
# MOSS-SoundEffect-V2.0
|
|
|
|
| 19 |
|
| 20 |
<p align="center">
|
|
|
|
| 21 |
<img src="https://speech-demo.oss-cn-shanghai.aliyuncs.com/moss_tts_demo/tts_readme_imgaes_demo/openmoss_x_mosi" height="50" align="middle" />
|
| 22 |
</p>
|
| 23 |
|
|
|
|
|
|
|
| 24 |
<div align="center">
|
| 25 |
+
<a href="https://github.com/OpenMOSS/MOSS-TTS/tree/main/moss_soundeffect_v2"><img src="https://img.shields.io/badge/Project%20Page-GitHub-blue"></a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 26 |
</div>
|
| 27 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 28 |
**MOSS-SoundEffect v2.0** is a text-to-audio model with a Diffusion Transformer (DiT) backbone trained with the Flow Matching objective, paired with a DAC VAE and a Qwen3 text encoder. It generates high-fidelity environmental, urban, creature, and human-action sound effects from natural-language prompts, with controllable duration up to 30 seconds at 48 kHz.
|
| 29 |
|
| 30 |
+
## 1. Overview
|
| 31 |
|
| 32 |
+
### 1.1 TTS Family Positioning
|
| 33 |
|
| 34 |
Within the MOSS-TTS Family, MOSS-SoundEffect is the dedicated **text-to-sound** model — the family member that turns natural-language captions into non-speech audio (ambience, urban scenes, creatures, human actions, short music-like clips). v2.0 supersedes the v1 discrete-token autoregressive backbone (`MossTTSDelay`) with a continuous-latent **Diffusion Transformer + Flow Matching** design.
|
| 35 |
|
| 36 |
+
### 1.2 Key Capabilities
|
| 37 |
|
| 38 |
- **Broad SFX coverage**: natural environments, urban environments, animals & creatures, human actions, and short musical/percussive clips.
|
| 39 |
- **Long-form generation**: stable audio up to **30 seconds** per call with the duration tag prepended to the prompt at training time.
|
| 40 |
- **Bilingual prompts**: trained with both **English and Chinese** captions.
|
| 41 |
|
| 42 |
+
### 1.3 Released Models
|
| 43 |
|
| 44 |
| Model | Architecture | DiT Variant | Parameters |
|
| 45 |
|---|---|---|---:|
|
|
|
|
| 54 |
| `sigma_shift` | 5.0 | Flow-match scheduler shift applied per call. |
|
| 55 |
| `seconds` | 10.0 | Output duration. Up to 30. |
|
| 56 |
|
| 57 |
+
## 2. Quick Start
|
| 58 |
|
| 59 |
+
### Environment Setup
|
| 60 |
|
| 61 |
We recommend a clean, isolated Python 3.12 environment to avoid dependency conflicts with the top-level MOSS-TTS environment.
|
| 62 |
|
|
|
|
| 77 |
-e ".[torch-cu128]"
|
| 78 |
```
|
| 79 |
|
| 80 |
+
### Basic Usage
|
| 81 |
|
| 82 |
```python
|
| 83 |
import torch
|