Capability

Music Generation

Instrumental generation: prompt-based, or style-matched from a reference track. Available in v5, v6, and v7.

Compat route available

POST /v{5,6,7}/generate/music covers generate_music with old-style field names (the old style field folds into prompt text, since there’s no separate field on the new side). See Compat Routes. similar_music has no compat route; use the native path below.

Quickstart

POST/v7/generate/musiccompat route, simplest way to start

curl -X POST https://apiv2.soundverse.ai/v7/generate/music \ -H "Authorization: Bearer sksoundverse_..." \ -H "Content-Type: application/json" \ -H "Idempotency-Key: music-req-001" \ -d '{ "prompt": "warm lo-fi hip-hop with vinyl crackle", "parameters": {"versions": 2} }'

Response: 201 {"job_id": "...", "status": "queued"}. Poll GET /v7/status?job_id=... or GET /v1/generations/{job_id}.

generate_music — native payload

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

FieldTypeRequiredDefaultDescription
promptstringNo""What to generate — genre, mood, instruments, tempo. Up to 1024 characters.
versionsintegerNo1Number of instrumental versions to generate. 1–3.

similar_music — native payload

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

FieldTypeRequiredDefaultDescription
instrumental_referencefile inputYesAn instrumental whose style to match. mp3/m4a, ~30s, up to 15MB. See Overview → Providing audio/file input for the ref/url/data_b64 shapes.
versionsintegerNo11–3.

Pricing

VersionRoyalty-FreeStandardDistributionSyncMaster
v5 / v6 / v7$0.07$0.11$0.14$0.28$0.70

USD per track, by license tier.