Capability
Lyrics
Generate song lyrics from a theme and optional style, mood, structure, and language direction.
Compat route available
POST /v1/generate/lyrics covers write_lyrics (old prompt → new theme). See Compat Routes.
Quickstart
POST/v1/generate/lyricscompat route
curl -X POST https://apiv2.soundverse.ai/v1/generate/lyrics \
-H "Authorization: Bearer sksoundverse_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: lyrics-req-001" \
-d '{"prompt": "long-distance love, leaving your hometown"}'write_lyrics — native payload
POST/v1/generationstool_id for (model, "write_lyrics")
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| theme | string | Yes | — | The central theme, topic, or story the lyrics should be about, e.g. 'long-distance love', 'leaving your hometown'. |
| style | string | No | "" | Musical style or genre, e.g. 'pop', 'hip-hop', 'folk ballad'. Influences phrasing and vocabulary. |
| mood | string | No | "" | Emotional tone, e.g. 'melancholic', 'triumphant', 'playful'. |
| language | string | No | "English" | Language to write the lyrics in. |
| structure | string | No | "" | Desired song structure, e.g. 'verse, chorus, verse, chorus, bridge, chorus'. Leave empty to let the model choose. |
| rhyme | boolean | No | true | Whether the lyrics should rhyme. Set false for free-verse / spoken-word. |
| explicit | boolean | No | false | Allow explicit language. When false, lyrics stay clean / radio-safe. |
| extra_instructions | string | No | "" | Any additional freeform instructions, e.g. 'mention rain', 'keep it under 16 lines'. |
Pricing
| Version | Royalty-Free | Standard | Distribution | Sync | Master |
|---|---|---|---|---|---|
| v5 | $0.02 | $0.02 | $0.02 | $0.02 | $0.02 |
USD per generation, by license tier.