Skip to main content
POST
Lyric Timings
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/aligned-lyrics and the parameters inside input. Both behave and bill the same.
When the task succeeds, the result is in data.result:
result.alignment is the per-line lyric timeline, each entry with its lyric and start and end seconds. result.waveform_data is the waveform of the whole track, useful for drawing a track view.

Authorizations

Authorization
string
header
required

Send your API key in the Authorization: Bearer YOUR_API_KEY header.

Body

application/json
music_id
string
required

Source Track: The track to work on. Use the music_id from an earlier result.

notify_hook
string<uri>

Notify hook: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.

Response

OK

code
enum<string>
required
Available options:
success
data
object
required
message
string