Developer docs

Set a song’s lyrics

MCP tool
set_song_lyrics
CLI
kinetune songs set-lyrics
POST/api/v1/songs/{song_id}/lyrics

Not sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.

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.

Authorization

headerAuthorizationBearer <token>

An organization API key (kt_live_…) or an OAuth access token

Path Parameters

song_id*string

The song id

Length1 <= length <= 120

Request Body

application/json
  1. body
lyrics*string

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

Length1 <= length <= 100000

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/songs/string/lyrics' \
  -H 'Content-Type: application/json' \
  -d '{
  "lyrics": "string"
}'
Example Response
Empty