🎛️ Synth Instruments
DSP instruments with a test keyboard: bass, lead, keys, drums
About this tool
Synth Instruments is a rack of thirty synthesised instruments: basslines (sub, deep house, acid, Reese, 808), hook leads (saw, square, supersaw, chiptune, whistle, brass), keys and plucks (bell, marimba, electric piano, glass), pads (warm, glass, choir, drone) and a full drum kit (kick, snare, clap, rim, hi-hat, shaker, tom, cowbell, clave). Pick one and play it on the on-screen keyboard, or hit a key on your computer keyboard. The instant preview runs in the browser, and Render plays the real pyo engine on the server so you can check how the instrument sits in a pattern. No samples, everything is generated from scratch.
API
POST /api/tools/synth-instruments/run (multipart/form-data) → JSON with
outputs[].url, a zip link and a config_url.
Every run also hands you the config JSON (button above). It is the request body - POST it straight back to replay the exact generation:
curl -X POST -H 'Content-Type: application/json' \\ --data @genbox-config-synth-instruments.json \\ /api/tools/synth-instruments/run
For AI agents · API specs
Technical specs
| Category | music |
|---|---|
| Slug | synth-instruments |
| Run endpoint | POST /api/tools/synth-instruments/run |
| Content type | multipart/form-data (with file uploads) or application/json |
| Response | JSON: job, notes, outputs[].url, zip, config_url |
| Rate limit | API: 1 request / minute / IP. Live preview and image renders have their own separate limits, plus a short global cooldown between renders (storm protection). Over a limit you get HTTP 429 + a Retry-After header (local requests are unlimited) |
| Machine-readable spec | GET /api/tools/synth-instruments |
| OpenAPI 3.1 (Swagger) | this tool (JSON) · all tools |
Request body
Every parameter accepted by the run endpoint, in request-body order.
Fields are optional unless marked required. The same schema is published as
OpenAPI 3.1.
Upload files with multipart/form-data; a JSON body replays a saved config.
| Parameter | Type | Required | Default / allowed values | Description |
|---|---|---|---|---|
instrument |
select | no | bass-sub · bass-deep · bass-acid · bass-reese · bass-pluck · bass-808 · bass-funk · lead-saw · lead-square · lead-supersaw · lead-chip · lead-whistle · lead-brass · keys-bell · keys-marimba · keys-piano · keys-glass · pad-warm · pad-glass · pad-choir · pad-drone · kick-808 · kick-punch · kick-click · snare-tight · snare-clap · snare-rim · hat-closed · hat-open · hat-shaker · hat-pedal · perc-tom · perc-cowbell · perc-clave |
Every instrument is synthesised from scratch: oscillators, filter, envelope and effects defined in instruments.json. |
keyboard |
keyboard | no | |
Clicks and computer keys play the chosen instrument. Octave buttons shift the range; the Render button below gives you the server-side pyo version. |
pattern |
text | no | |
Notes separated by spaces, - is a rest, A1~ holds. Drums ignore the note name and just use the rhythm. |
tempo_bpm |
number | no | 120 |
|
format |
select | no | wav · mp3 |
|
filename |
text | no | |
Call it from an agent
GET /api/tools/synth-instruments- machine-readable spec of this tool (inputs, category, API block).GET /api/tools- list of every tool plus the categories.POST /api/tools/synth-instruments/run- run it. Acceptsmultipart/form-data(with files) or a rawapplication/jsonbody. Returns JSON withoutputs[].url,zipandconfig_url.- The
config_urlJSON is the request body - POST it back to replay the same generation.
# agent example curl -s https://genbox.eu/api/tools/synth-instruments/run \\ -H 'Content-Type: application/json' \\ --data @genbox-config-synth-instruments.json
Rate limits
- Max 1 request per minute per IP on the run endpoint.
- Over the limit you get HTTP 429 with
retry_after(seconds) - wait that long and retry. - Higher limits and API keys are coming soon: an API key will lift the per-IP throttle. Not available yet.