Render a sound
sound_effectRenders one sound from the engine's own synth as a stereo WAV, or an ambience of the beds mixed together. Give sound (a name from sound_list) with a, b and c as sound_list says, or give ambience: any of engine, air, surf, rain, drum, gull and creak, each 0 to 1, with seconds (1 to 30, default 10; loop true makes it seamless, its end crossfaded into its start, for a game that plays it on repeat; an ambience otherwise fades out). seed varies a one-shot, rate is 44100 or 48000, and peak_db (-30 to 0, default -3) is where the loudest sample sits, so a footstep and a thunder come back at one level; raw true keeps the synth's own. Nothing is sampled from a recording. Costs 1 unit.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "sound_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| a | No | The sound's first parameter, as sound_list says what it does for this sound. | |
| b | No | The sound's second parameter, 0 to 1, as sound_list says. | |
| c | No | The sound's third parameter, -1 to 1, as sound_list says. | |
| raw | No | True to keep the synth's own level instead of normalising to peak_db. | |
| loop | No | True to make an ambience seamless, its end crossfaded into its start. | |
| rate | No | Sample rate in hertz: 44100 or 48000. | |
| seed | No | A whole number that varies a one-shot sound. | |
| sound | No | A sound name from sound_list. Give this, or ambience. | |
| peak_db | No | Where the loudest sample sits in dBFS, -30 to 0 (default -3). | |
| seconds | No | Length of an ambience in seconds, 1 to 30 (default 10). | |
| ambience | No | Instead of sound: a mix of beds (engine, air, surf, rain, drum, gull, creak), each a level from 0 to 1. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | Milliseconds the run took. | |
| job | Yes | The job id; the job tool reads it. | |
| verb | No | The tool that made it. | |
| files | No | Files made, each with a name, type, size and a signed URL. | |
| units | No | Units this call cost. | |
| result | No | The engine's own answer, a JSON document. | |
| status | No | queued when the job runs in the background. |