songs

Upload a song

Add a song: master audio and square cover art

Audio: MP3, WAV or M4A up to 250 MB. Cover: a square JPEG or PNG, 1000–6000 px (3000×3000 recommended), up to 20 MB; it is kept at 1536, 640 and 160 px, not as uploaded. The song is analyzed next (lyrics, beats, sections): poll get_song until analysis.status is "ready", usually about a minute. Pass lyrics (or set them later with set_song_lyrics) to have the videos spell every word right.

post/api/v1/songs

Request

  • Base URL: https://kinetune.com
  • URL: https://kinetune.com/api/v1/songs
  • 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)

Request body

artist_idstring required

The artist id

titlestring required

The song title

languagestring

Lyrics language (ISO 639-1, e.g. "en"); detected when omitted

audio_urlstring uri

A public https URL of the master audio

cover_art_urlstring uri

A public https URL of the square cover art

lyricsstring

Optional. 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 once the song is analyzed (get_song: analysis.lyrics.status "mismatch")

Response

OK

Changes

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