Workflow

Humming to Song

Turn a hummed, whistled or tapped melody into a complete, produced song. You supply the lyrics and a style, and Soundverse builds the arrangement and vocals around your tune.

Quickstart
Request fields
How it works
Results and playback
Pricing

Dedicated route only

This workflow uses POST /v1/hummed-songs. It runs a fixed multi-step pipeline; there is no generic tool_id for it.

Quickstart

POST/v1/hummed-songshumming to song

curl -X POST https://apiv2.soundverse.ai/v1/hummed-songs \
  -H "Authorization: Bearer sksoundverse_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: humming-to-song-001" \
  -d '{
  "melody_file_id": "018f0000-0000-7000-8000-000000000002",
  "lyrics": "line one\nline two",
  "song_style": "indie folk, wistful, female vocals",
  "license": "royalty_free"
}'

The melody_file_id must be an active uploaded audio file owned by the authenticated enterprise account.

Getting a melody_file_id

Upload the file first via POST /v1/files — either {"source_url": "..."} if you already host it, or a multipart/form-data file part to upload bytes directly. Both return a file_id owned by your account, ready to pass here.

Request fields

Field	Type	Required	Default	Description
melody_file_id	uuid	Yes	—	ID of the hummed, whistled or tapped melody recording, an audio file owned by the authenticated enterprise account (upload it first via POST /v1/files). 15-30 seconds of a clearly carried tune works best. Maximum 30 MiB.
lyrics	string	Yes	—	The lyrics the song should be sung with, line breaks included. Supplied rather than written for you: the enterprise workflow has no lyric-writing step.
song_style	string	Yes	—	The style to produce the song in: genre, mood, and the singer's voice/gender (e.g. 'indie folk, wistful, female vocals').
license	license tier	No	"royalty_free"	License tier to price and attach to every step of the pipeline.

How it works

Each request runs 1 step:

Building a full song around the hummed melody.

Progress streams over GET /v1/generations/{task_id}/stream as each step starts and finishes.

Notes

Lyrics are required: the finished song is sung to the lyrics you supply.

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:

Song generation from a melody

There is no fixed per-request price; the total depends on the input and on which optional steps run.

← Add an Instrument LayerTrending Genre Song →