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")
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| song | file input | Yes | — | The track to apply effects to. |
| effects | array | Yes | — | An 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
| Version | Royalty-Free | Standard | Distribution | Sync | Master |
|---|---|---|---|---|---|
| v5 | $0.03 | $0.03 | $0.03 | $0.03 | $0.03 |
USD per call, by license tier.