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")
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| prompt | string | No | "" | What to generate — genre, mood, instruments, tempo. Up to 1024 characters. |
| versions | integer | No | 1 | Number of instrumental versions to generate. 1–3. |
similar_music — native payload
POST/v1/generationstool_id for (model, "similar_music")
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| instrumental_reference | file input | Yes | — | An instrumental whose style to match. mp3/m4a, ~30s, up to 15MB. See Overview → Providing audio/file input for the ref/url/data_b64 shapes. |
| versions | integer | No | 1 | 1–3. |
Pricing
| Version | Royalty-Free | Standard | Distribution | Sync | Master |
|---|---|---|---|---|---|
| v5 / v6 / v7 | $0.07 | $0.11 | $0.14 | $0.28 | $0.70 |
USD per track, by license tier.