Genbox

← all tools · music

🎛️ 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.

Bassline, hook, keys, pad or a drum. The description under the picker tells you what it sounds like.

Every instrument is synthesised from scratch: oscillators, filter, envelope and effects defined in instruments.json.

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

Categorymusic
Slugsynth-instruments
Run endpointPOST /api/tools/synth-instruments/run
Content typemultipart/form-data (with file uploads) or application/json
ResponseJSON: job, notes, outputs[].url, zip, config_url
Rate limitAPI: 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 specGET /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.

ParameterTypeRequiredDefault / allowed valuesDescription
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. Accepts multipart/form-data (with files) or a raw application/json body. Returns JSON with outputs[].url, zip and config_url.
  • The config_url JSON 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.