Stable Audio Open 1.0 generates variable-length (up to 47s) stereo audio at 44.1kHz from text prompts. It comprises three components: an autoencoder that compresses waveforms into a manageable sequence length, a T5-based text embedding for text conditioning, and a transformer-based diffusion (DiT) model that operates in the latent space of the autoencoder.
This model is made to be used with the stable-audio-tools library for inference, for example:
python
1import torch
2import torchaudio
3from einops import rearrange
4from stable_audio_tools import get_pretrained_model
5from stable_audio_tools.inference.generation import generate_diffusion_cond
6device ="cuda"if torch.cuda.is_available()else"cpu"7# Download model8model, model_config = get_pretrained_model("stabilityai/stable-audio-open-1.0")9sample_rate = model_config["sample_rate"]10sample_size = model_config["sample_size"]11model = model.to(device)12# Set up text and timing conditioning13conditioning =[{14"prompt":"128 BPM tech house drum loop",15"seconds_start":0,16"seconds_total":3017}]18# Generate stereo audio19output = generate_diffusion_cond(20 model,21 steps=100,22 cfg_scale=7,23 conditioning=conditioning,24 sample_size=sample_size,25 sigma_min=0.3,26 sigma_max=500,27 sampler_type="dpmpp-3m-sde",28 device=device
29)30# Rearrange audio batch to a single sequence31output = rearrange(output,"b d n -> d (b n)")32# Peak normalize, clip, convert to int16, and save to file33output = output.to(torch.float32).div(torch.max(torch.abs(output))).clamp(-1,1).mul(32767).to(torch.int16).cpu()34torchaudio.save("output.wav", output, sample_rate)
Using with diffusers
Make sure you upgrade to the latest version of diffusers: pip install -U diffusers. And then you can run:
py
1import torch
2import soundfile as sf
3from diffusers import StableAudioPipeline
4pipe = StableAudioPipeline.from_pretrained("stabilityai/stable-audio-open-1.0", torch_dtype=torch.float16)5pipe = pipe.to("cuda")6# define the prompts7prompt ="The sound of a hammer hitting a wooden surface."8negative_prompt ="Low quality."9# set the seed for generator10generator = torch.Generator("cuda").manual_seed(0)11# run the generation12audio = pipe(13 prompt,14 negative_prompt=negative_prompt,15 num_inference_steps=200,16 audio_end_in_s=10.0,17 num_waveforms_per_prompt=3,18 generator=generator,19).audios
20output = audio[0].T.float().cpu().numpy()21sf.write("hammer.wav", output, pipe.vae.sampling_rate)
Refer to the documentation for more details on optimization and usage.
Model Details
Model type: Stable Audio Open 1.0 is a latent diffusion model based on a transformer architecture.
Our dataset consists of 486492 audio recordings, where 472618 are from Freesound and 13874 are from the Free Music Archive (FMA). All audio files are licensed under CC0, CC BY, or CC Sampling+. This data is used to train our autoencoder and DiT. We use a publicly available pre-trained T5 model (t5-base) for text conditioning.
Attribution
Attribution for all audio recordings used to train Stable Audio Open 1.0 can be found on our attribution page.
Mitigations
We conducted an in-depth analysis to ensure no unauthorized copyrighted music was present in our training data before we began training.
To that end, we first identified music samples in Freesound using the PANNs music classifier based on AudioSet classes. The identified music samples had at least 30 seconds of music that was predicted to belong to a music-related class with a threshold of 0.15 (PANNs output probabilities range from 0 to 1). This threshold was determined by classifying known music examples from FMA and ensuring no false negatives were present.
The identified music samples were sent to Audible Magic’s identification services, a trusted content detection company, to ensure the absence of copyrighted music. Audible Magic flagged suspected copyrighted music, which we subsequently removed before training on the dataset. The majority of the removed content was field recordings in which copyrighted music was playing in the background. Following this procedure, we were left with 266324 CC0, 194840 CC-BY, and 11454 CC Sampling+ audio recordings.
We also conducted an in-depth analysis to ensure no copyrighted content was present in FMA's subset. In this case, the procedure was slightly different because the FMA subset consists of music signals. We did a metadata search against a large database of copyrighted music (https://www.kaggle.com/datasets/maharshipandya/-spotify-tracks-dataset) and flagged any potential match. The flagged content was reviewed individually by humans. After this process, we ended up with 8967 CC-BY and 4907 CC0 tracks.
Use and Limitations
Intended Use
The primary use of Stable Audio Open is research and experimentation on AI-based music and audio generation, including:
Research efforts to better understand the limitations of generative models and further improve the state of science.
Generation of music and audio guided by text to explore current abilities of generative AI models by machine learning practitioners and artists.
Out-of-Scope Use Cases
The model should not be used on downstream applications without further risk evaluation and mitigation. The model should not be used to intentionally create or disseminate audio or music pieces that create hostile or alienating environments for people.
Limitations
The model is not able to generate realistic vocals.
The model has been trained with English descriptions and will not perform as well in other languages.
The model does not perform equally well for all music styles and cultures.
The model is better at generating sound effects and field recordings than music.
It is sometimes difficult to assess what types of text descriptions provide the best generations. Prompt engineering may be required to obtain satisfying results.
Biases
The source of data is potentially lacking diversity and all cultures are not equally represented in the dataset. The model may not perform equally well on the wide variety of music genres and sound effects that exist. The generated samples from the model will reflect the biases from the training data.
