| --- |
| title: Stable Audio 3 Medium API |
| emoji: 🎵 |
| colorFrom: indigo |
| colorTo: purple |
| sdk: gradio |
| sdk_version: 6.14.0 |
| app_file: app.py |
| pinned: false |
| license: other |
| short_description: Music generation API proxying stable-audio-3-medium. |
| models: |
| - stabilityai/stable-audio-3-medium |
| --- |
| |
| # Stable Audio 3 Medium — Music API |
|
|
| A thin, stable API wrapper around |
| [`stabilityai/stable-audio-3`](https://huggingface.co/spaces/stabilityai/stable-audio-3), |
| pinned to the **Medium — general audio** variant |
| ([`stabilityai/stable-audio-3-medium`](https://huggingface.co/stabilityai/stable-audio-3-medium)). |
|
|
| This Space uses no GPU of its own — it forwards to the upstream ZeroGPU Space and |
| exposes a single keyword-addressable endpoint, `/generate`, so callers don't have |
| to track upstream's positional, UI-derived signature. |
|
|
| ## Endpoint |
|
|
| `POST /generate` → `(wav_filepath, status_string)` |
|
|
| | param | type | default | notes | |
| |---|---|---|---| |
| | `prompt` | str | — | required | |
| | `duration` | float | 60 | seconds, 1–380 | |
| | `steps` | float | 8 | diffusion steps | |
| | `cfg_scale` | float | 1.0 | | |
| | `sampler_type` | str | `pingpong` | `pingpong`, `euler`, `rk4`, `dpmpp` | |
| | `seed` | int | 0 | 0 = random | |
| | `negative_prompt` | str | `""` | routes via upstream `/infer_advanced` when set | |
| | `hf_token` | str | — | **required**; your own HF token (a read token suffices) | |
|
|
| ## Usage |
|
|
| ```python |
| from gradio_client import Client |
| |
| client = Client("sleeper371/stable-audio-3-medium-api") |
| wav_path, status = client.predict( |
| prompt="Warm analog house groove, deep sub bass, shuffled hats 122 BPM", |
| duration=30, |
| hf_token="hf_...", # your token — your quota |
| api_name="/generate", |
| ) |
| print(status, wav_path) |
| ``` |
|
|
| ## Configuration |
|
|
| This Space stores **no credentials**. Each caller passes their own `hf_token`, |
| which is forwarded to upstream so ZeroGPU quota is charged to that caller — never |
| to the Space owner. Tokens are never logged or persisted. |
|
|
| | variable | purpose | |
| |---|---| |
| | `UPSTREAM_SPACE` | Override the upstream Space id. Defaults to `stabilityai/stable-audio-3`. | |
| | `JOB_TIMEOUT` | Wall-clock budget per upstream job, including queue wait. Defaults to `900` seconds. | |
| | `HTTPX_TIMEOUT` | HTTP timeout, which bounds the *download* of the result WAV (~67 MB at the 380s maximum). Defaults to `600` seconds. | |
|
|
