songs

Set a song’s lyrics

Give a song its own lyrics, or replace them

The song’s lyrics as text: plain (Suno-style [Verse]/[Chorus] tags and (x2) marks are fine), or the contents of an SRT, WebVTT or LRC file. Every word is still timed from the audio: your text fixes misheard words and sets where lines break in videos. A part sung again (a chorus) can be written once; lyrics that don’t match what’s sung, or cover only part of it, are refused (409, the song unchanged). They are checked right away (analysis.lyrics in the answer says what changed), or once the analysis finishes if it hasn’t (202). Videos made from then on use them; videos already made stay as they are.

post/api/v1/songs/{song_id}/lyrics

Request

  • Base URL: https://kinetune.com
  • URL: https://kinetune.com/api/v1/songs/{song_id}/lyrics
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://kinetune.com/api/auth/oauth2/authorize, token URL https://kinetune.com/api/auth/oauth2/token, scopes: music:write, videos:write)

Path parameters

song_idstring required

The song id

Request body

lyricsstring required

The lyrics: text, or an SRT, WebVTT or LRC file’s contents

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.