{
  "hf_id": "stabilityai/stable-audio-open-1.0",
  "meta": {
    "title": "Stable Audio Open",
    "slug": "stable-audio-open",
    "provider": "Stability AI",
    "description": "Text-to-audio generation model (1.2B params) producing up to ~47 s stereo audio at 44.1 kHz, served via vLLM-Omni",
    "date_added": "2026-01-26",
    "date_updated": "2026-08-15",
    "tasks": [
      "omni"
    ],
    "related_recipes": [
      "stabilityai/stable-diffusion-3.5-medium"
    ]
  },
  "model": {
    "model_id": "stabilityai/stable-audio-open-1.0",
    "min_vllm_version": "0.22.0",
    "architecture": "dense",
    "parameter_count": "1.2B",
    "active_parameters": "1.2B",
    "context_length": 0,
    "base_args": [
      "--trust-remote-code",
      "--enforce-eager",
      "--gpu-memory-utilization",
      "0.9"
    ],
    "base_env": {},
    "install": {
      "pip": {
        "command": "uv venv\nsource .venv/bin/activate\nuv pip install -U vllm --torch-backend auto"
      },
      "docker": {
        "command": "docker pull vllm/vllm-openai:latest"
      },
      "extras": [
        {
          "note": "vLLM 0.22.0 or newer",
          "command": "uv pip install 'vllm>=0.22.0'"
        },
        {
          "note": "vllm-omni provides the audio generation backend",
          "command": "uv pip install git+https://github.com/vllm-project/vllm-omni.git"
        },
        {
          "note": "soundfile (recommended) or scipy for WAV output",
          "command": "uv pip install soundfile"
        }
      ]
    }
  },
  "omni": {
    "tasks": [
      "t2a"
    ]
  },
  "features": {},
  "opt_in_features": [],
  "variants": {
    "default": {
      "precision": "bf16",
      "vram_minimum_gb": 19,
      "description": "BF16 weights for text-to-audio generation (via vLLM-Omni)"
    }
  },
  "hardware_overrides": {},
  "guide": "## Overview\n\n[Stable Audio Open 1.0](https://huggingface.co/stabilityai/stable-audio-open-1.0) is\nStability AI's text-to-audio generation model (~1.2B parameters). It produces stereo\naudio at 44.1 kHz, up to ~47 seconds. Served via **vLLM-Omni** (not standard vLLM).\n\nLimitations:\n- No realistic vocals (no singing or speech).\n- English-only training data.\n- Better at sound effects than complex music.\n\n## Prerequisites\n\n- vLLM-Omni on top of vLLM 0.22.0 or newer\n- `soundfile` or `scipy` for saving audio\n\n## Installation\n\n```bash\nuv venv\nsource .venv/bin/activate\nuv pip install git+https://github.com/vllm-project/vllm-omni.git\n\n# Audio saving\nuv pip install soundfile\n```\n\n## Python Usage\n\n```python\nimport torch\nimport soundfile as sf\nfrom vllm_omni.entrypoints.omni import Omni\n\nomni = Omni(model=\"stabilityai/stable-audio-open-1.0\")\ngenerator = torch.Generator(device=\"cuda\").manual_seed(42)\n\naudio = omni.generate(\n    \"The sound of a dog barking\",\n    negative_prompt=\"Low quality.\",\n    generator=generator,\n    guidance_scale=7.0,\n    num_inference_steps=100,\n    extra={\"audio_start_in_s\": 0.0, \"audio_end_in_s\": 10.0},\n)\n\naudio_data = audio[0].cpu().float().numpy().T  # [samples, channels]\nsf.write(\"output.wav\", audio_data, 44100)\n```\n\n## CLI Usage (from vLLM-Omni repo)\n\n```bash\npython examples/offline_inference/text_to_audio/text_to_audio.py \\\n  --model stabilityai/stable-audio-open-1.0 \\\n  --prompt \"The sound of a dog barking\" \\\n  --audio-length 10.0 \\\n  --num-inference-steps 100 \\\n  --guidance-scale 7.0 \\\n  --output dog_barking.wav\n```\n\n## Key Parameters\n\n| Parameter | Default | Description |\n|-----------|---------|-------------|\n| `audio_start_in_s` | 0.0 | Start time in seconds |\n| `audio_end_in_s` | 10.0 | End time in seconds |\n| `num_inference_steps` | 100 | Denoising steps (higher = better quality, slower) |\n| `guidance_scale` | 7.0 | Classifier-free guidance scale |\n| `negative_prompt` | \"Low quality.\" | Text to avoid |\n| `num_waveforms` | 1 | Samples per prompt |\n| `sample_rate` | 44100 | Output sample rate (Hz) |\n\n## License\n\nReleased under the Stability AI Community License. Commercial use requires a separate license.\n\n## References\n\n- [Stable Audio Open on Hugging Face](https://huggingface.co/stabilityai/stable-audio-open-1.0)\n- [vLLM-Omni text-to-audio example](https://github.com/vllm-project/vllm-omni/blob/main/examples/offline_inference/text_to_audio/text_to_audio.py)\n",
  "source": {
    "source": "vllm-omni",
    "repo": "vllm-project/vllm-omni",
    "ref": "main",
    "sha": "cda4a1ef83b295ba332146a7709e6277725edc9f",
    "path": "recipes/models/stabilityai/stable-audio-open-1.0.yaml",
    "edit_url": "https://github.com/vllm-project/vllm-omni/edit/main/recipes/models/stabilityai/stable-audio-open-1.0.yaml",
    "overlays": []
  }
}