Capability

Audio Effect

Apply a chain of audio effects — compression, EQ, reverb, and more — to an existing track.

Native only — new capability

No compat route exists for audio effects — it wasn’t part of the old Enterprise API this compat layer mirrors. Call POST /v1/generations directly.

audio_effect — native payload

POST/v1/generationstool_id for (model, "audio_effect")

FieldTypeRequiredDefaultDescription
songfile inputYesThe track to apply effects to.
effectsarrayYesAn ordered chain of 1–8 effects, applied left to right. See Effect entries below.

Effect entries

Each entry in effects is {"name": "<effect name>", "params": {...}}. params is optional — omitted keys fall back to defaults. name is one of 14 values: compressor, limiter, gain, high_pass, low_pass, peak_eq, high_shelf, low_shelf, reverb, delay, chorus, phaser, distortion, noise_gate.

A few representative defaults:

{"threshold_db": -20, "ratio": 4, "attack_ms": 5, "release_ms": 100}

Any *_db param is clamped server-side to [-60, 60]; any frequency/cutoff param is clamped to [20, 20000].

Example request:

curl -X POST https://apiv2.soundverse.ai/v1/generations \ -H "Authorization: Bearer sksoundverse_..." \ -H "Content-Type: application/json" \ -H "Idempotency-Key: effect-req-001" \ -d '{ "tool_id": "<audio_effect tool_id>", "payload_json": "{\"song\": {\"url\": \"https://example.com/track.mp3\"}, \"effects\": [{\"name\": \"compressor\"}, {\"name\": \"reverb\", \"params\": {\"wet_level\": 0.4}}]}" }'

Pricing

VersionRoyalty-FreeStandardDistributionSyncMaster
v5$0.03$0.03$0.03$0.03$0.03

USD per call, by license tier.