soundverse Workflow
Trending Genre Song
Generate a complete song in a genre you choose, or in whatever genre is trending in music right now. Lyrics can be supplied or written for you. This route takes no input file.
Dedicated route only
This workflow uses POST /v1/trending-songs. It runs a fixed multi-step pipeline; there is no generic tool_id for it.
Quickstart
POST/v1/trending-songstrending genre song
curl -X POST https://apiv2.soundverse.ai/v1/trending-songs \
-H "Authorization: Bearer sksoundverse_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: trending-song-001" \
-d '{
"genre": "synthwave",
"lyrics": "neon rain\non the avenue",
"license": "royalty_free"
}'Request fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| genre | string | No | — | Genre or style for the song (e.g. 'synthwave', 'afrobeats'). Omit to use whichever genre is trending in music right now, found with a web search (billed as one extra sub-call). |
| lyrics | string | No | — | The full lyrics to sing, line breaks included. Omit to have original lyrics written for you by the lyric writer (billed as one extra sub-call). |
| license | license tier | No | "royalty_free" | License tier to price and attach to every step of the pipeline. |
How it works
Each request runs 3 steps in order. The first two are skipped when you supply the value yourself:
- Finding the genre that is trending right now (skipped when you pass a genre).
- Writing lyrics for the song (skipped when you pass lyrics).
- Generating the full song.
Progress streams over GET /v1/generations/{task_id}/stream as each step starts and finishes.
Notes
Pass genre and lyrics to use your own as given. Omit genre to use the genre trending right now (one extra web search), and omit lyrics to have lyrics written for you (one extra lyric-writer call).
Results and playback
Poll GET /v1/generations/{task_id} until the task is completed. The finished result is added to the authenticated account’s Soundverse Library. Enterprise API outputs are hidden from public/profile surfaces by default.
For API-only download, resolve the output’s file_id with GET /v1/files/{file_id}/url and use the returned short-lived signed URL.
Pricing
This workflow is priced pass-through: you are billed for each step the pipeline runs, at that step’s enterprise rate, in the license tier you requested. The pipeline itself adds no separate fee, and your billing ledger shows one entry per step. The steps that carry the cost are:
- Web search (only when genre is omitted)
- Lyric writing (only when lyrics are omitted)
- Song generation
There is no fixed per-request price; the total depends on the input and on which optional steps run.