Download a sound
download_soundGet the full-quality file (usually WAV) for one sound, level-matched to the rest of the catalog (one gain, no compression; gain_db says how much) unless you pass variant "original" for the untouched master, as a direct link that needs no header and works for 15 minutes. Fetch it right away with the returned curl command (curl -L -o <file_name> ""). If the link has expired, call download_sound again. If you can't save files and give the person the link instead, also give them page_url, the sound's page on soundza.com: the link stops working after 15 minutes, the page never does. Save each file once and reuse it by sound id: a sound's file never changes. Each different sound counts toward the key's download limits (fetching one again within the week doesn't), and every call counts toward a cap on file fetches, so download only sounds you mean to use. optional_license_file is a ready-made license note. If you're adding sounds to a project folder, such as a game's audio folder, you can save it alongside them: optional_license_file.header followed by optional_license_file.entry, in a file named optional_license_file.filename; for more sounds in the same folder, append just optional_license_file.entry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The sound's id, from search_sounds. | |
| variant | No | "normalized" (default): level-matched to the catalog. "original": the untouched master. |