README.md

metadata

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.