Music endpoints
/v1/music/*Song generation, uploads, analysis, remixing, and region-level editing.
What this section covers
Endpoint-level reference for the current /v1/music/* surface.
The music API is the broadest part of the Wubble v1 surface. It covers greenfield generation, derivative workflows, uploads, analysis, and track editing.
Most write operations are asynchronous. Treat request_id as your durable handle, then poll GET/v1/requests/:requestId or subscribe to webhooks for completion.
Start here
Use POST/v1/music/songs for the primary text-to-song flow.
Use uploads when later calls need a vocal_id or upload_audio_id.
Reach for remix, tracks, and region edit only after you already have a source asset.
Create
Primary entry points for new music and lyrics.
Generate songs
/v1/music/songsCreate a full song from a prompt, with optional lyrics.
Generate instrumentals
/v1/music/instrumentalsCreate instrumental music from a text brief.
Generate lyrics
/v1/music/lyricsGenerate lyrics synchronously from a short brief.
Extend lyrics
/v1/music/lyrics/extendContinue an existing lyric draft with optional extra direction.
Extend songs
/v1/music/songs/extendContinue an existing song from a chosen point in the track.
Uploads and vocal workflows
Bring your own reference material into the pipeline.
Upload vocal reference
/v1/music/vocals/uploadUpload a vocal reference file and receive a vocal_id for later clone jobs.
Generate with cloned vocals
/v1/music/vocals/cloneGenerate a music job using a previously uploaded vocal reference.
Upload source audio
/v1/music/uploadsUpload a large audio file for downstream music operations.
Analysis and derivatives
Understand, remix, separate, or edit existing sources.
Analyze lyrics from uploaded audio
/v1/music/analyze/lyricsExtract lyric structure and timing information from a prior upload.
Describe audio from URL
/v1/music/analyze/descriptionGenerate a descriptive analysis for an audio file at a URL.
Analyze and separate stems
/v1/music/analyze/stemsRun stem separation from a source audio URL.
Remix songs
/v1/music/songs/remixCreate a remix from a prior song or uploaded audio source.
Generate isolated tracks
/v1/music/tracksGenerate isolated tracks or stems-style outputs from a prior song or upload.
Edit track regions
/v1/music/tracks/editEdit a selected region of a track with precise timing boundaries.
Reserved
Known route placeholders that are not yet live.