stable_audio.md

Stable Audio

Stable Audio is wired as --family stable_audio --task gen. It generates music or sound effects from text, and the music model can condition generation on input audio for init-audio or inpainting workflows.

Stable Audio 3 Small Music

This is the default music-generation package. Use it for text-to-music, init-audio, and inpainting.

Field	Value
Family	stable_audio
Model directory	models/stable-audio-3-small-music
Task	gen
Main modes	Text-to-music, init-audio, inpainting
Prompt language	en
Optional audio input	--audio with audio_input_kind=init_audio or audio_input_kind=inpaint_audio

Text to music:

audiocpp_cli --task gen --family stable_audio --model models/stable-audio-3-small-music --backend cuda --text "uplifting house music with bright synths and festival drums" --duration-seconds 30 --out music.wav

Init audio:

audiocpp_cli --task gen --family stable_audio --model models/stable-audio-3-small-music --backend cuda --audio input.wav --text "turn this into mellow downtempo music with deeper bass" --duration-seconds 10 --request-option audio_input_kind=init_audio --request-option init_noise_level=0.45 --out init_audio.wav

Inpaint audio:

audiocpp_cli --task gen --family stable_audio --model models/stable-audio-3-small-music --backend cuda --audio input.wav --text "replace the masked sections with a tight snare fill and bright guitar swell" --duration-seconds 10 --request-option audio_input_kind=inpaint_audio --request-option inpaint_mask_start_seconds=2.5,6.5 --request-option inpaint_mask_end_seconds=3.5,8.0 --out inpaint.wav

Stable Audio 3 Small SFX

Use this package for short sound effects. It uses the same gen task but is intended for SFX prompts instead of music prompts.

Field	Value
Family	stable_audio
Model directory	models/stable-audio-3-small-sfx
Task	gen
Main mode	Text-to-sound-effects
Prompt language	en
Optional audio input	Not part of the basic SFX command

audiocpp_cli --task gen --family stable_audio --model models/stable-audio-3-small-sfx --backend cuda --text "footsteps on gravel, close perspective, crisp natural stone texture" --duration-seconds 8 --out sfx.wav

Stable Audio 3 Medium

Use the medium package for the larger Stable Audio 3 music model. It uses the same user-facing controls as the music path.

Field	Value
Family	stable_audio
Model directory	models/stable-audio-3-medium
Task	gen
Main mode	Text-to-music
Prompt language	en
Optional audio input	Supported by the Stable Audio request path when the model package provides the needed components

audiocpp_cli --task gen --family stable_audio --model models/stable-audio-3-medium --backend cuda --text "wide cinematic ambient music with soft piano and evolving strings" --duration-seconds 30 --out music_medium.wav

Parameters

Option	Values	Default	Meaning
--text	prompt text	required	Music or sound-effect prompt.
--audio	WAV path	not set	Source audio for init-audio or inpainting.
--duration-seconds	seconds[,seconds...]	120	Target duration per prompt. Use one value for all prompts, or one comma-separated value per Stable Audio batch_size item.
--num-inference-steps	integer	8	RF diffusion steps.
--guidance-scale	float	1.0	Classifier-free guidance scale.
--seed	integer	random if omitted	Generation seed.
--request-option negative_prompt=<text>	text	empty string	Negative prompt.
--request-option sampler=<name>	pingpong, euler, dpmpp-2m, dpmpp-3m-sde	pingpong	Diffusion sampler for Stable Audio 3. The foundation/medium path also accepts the DPM++ samplers.
--request-option apg_scale=<float>	float	1.0	Adaptive projected guidance scale.
--request-option batch_size=<n>	integer	1	Prompt batch size.
--request-option duration_padding_seconds=<seconds>	seconds	6.0	Extra generated padding before truncation.
`--request-option truncate_output_to_duration=true	false`	bool	true
`--request-option chunked_decode=true	false`	bool	true
--request-option audio_input_kind=<kind>	init_audio, inpaint_audio	init_audio when --audio is provided	How the model uses input audio.
--request-option init_noise_level=<float>	0..1	1.0	Strength for audio-conditioned generation.
--request-option inpaint_mask_start_seconds=<list>	comma-separated seconds	not set	Inpaint region start times.
--request-option inpaint_mask_end_seconds=<list>	comma-separated seconds	not set	Inpaint region end times.
`--session-option stable_audio.mem_saver=true	false`	bool	false

For backend weight-type controls, use audiocpp_cli --inspect --model <model-dir> --family stable_audio.