| title: Kicks API | |
| emoji: 🥁 | |
| colorFrom: purple | |
| colorTo: blue | |
| sdk: docker | |
| app_port: 7860 | |
| # Kicks API | |
| VAE-powered kick drum synthesizer API (FastAPI). Decodes five PCA sliders through | |
| the VAE's latent space into a spectrogram, then to 44.1 kHz audio. Uses the | |
| BigVGAN v2 vocoder on GPU, with a Griffin-LIM fallback on CPU. | |
| ## API Endpoints | |
| - `GET /config` — Returns slider definitions (PC names, ranges) | |
| - `GET /generate?pc1=0.5&pc2=0.5&pc3=0.5&pc4=0.5&pc5=0.5` — Returns WAV audio | |
| - `GET /spectrogram?pc1=0.5&pc2=0.5&pc3=0.5&pc4=0.5&pc5=0.5` — Returns spectrogram JSON | |
| - `GET /health` — Liveness/readiness check | |
| Slider values are 0.0–1.0. Default is 0.5. | |