Capability
Singing Generation
Generate a vocal performance from a prompt and lyrics, optionally guided by a reference voice sample. Available in v5, v6, and v7.
Compat route available
POST /v{5,6,7}/generate/singing covers generate_singing with old-style field names. This is a new URL, not a literal recreation — the old singing endpoint was version-less (/v2/generate/ai-singing-gen), predating the v5/v6/v7 family entirely, so this path is offered for consistency with the rest of the compat surface rather than resurrecting the old one. See Compat Routes.
Quickstart
POST/v7/generate/singingcompat route, simplest way to start
curl -X POST https://apiv2.soundverse.ai/v7/generate/singing \
-H "Authorization: Bearer sksoundverse_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: singing-req-001" \
-d '{
"styleOfMusic": "warm soul, female alto",
"lyrics": "walking through the city lights...",
"audioUrl": "https://example.com/voice-sample.mp3"
}'The compat route maps styleOfMusic→prompt and audioUrl→vocal_reference internally. Response: 201 {"job_id": "...", "status": "queued"}.
generate_singing — native payload
POST/v1/generationstool_id for (model, "generate_singing")
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| prompt | string | No | "" | Vocal style — mood, timbre, genre. Up to 1024 characters. |
| lyrics | string | No | "" | Lyrics to sing. Up to 3000 characters. |
| vocal_reference | file input | No | — | An optional voice sample to sing in a similar voice. mp3/m4a, ~30s, up to 15MB. |
| versions | integer | No | 1 | Number of vocal versions to generate. 1–3. |
The underlying worker fleet also has a sibling similar_singing operation, but it is not currently enterprise-priced or seeded — it isn’t available through this API today.
Pricing
| Version | Royalty-Free | Standard | Distribution | Sync | Master |
|---|---|---|---|---|---|
| v5 / v6 / v7 | $0.09 | $0.14 | $0.18 | $0.36 | $0.90 |
USD per generation, by license tier.