Change a song’s cover
- MCP tool
set_song_cover- CLI
kinetune songs set-cover
/api/v1/songs/{song_id}/coverNot sent from the docs: it uploads files to your workspace. Run it with curl, the CLI or its MCP tool.
Replace a song’s cover art, or add one
Adds cover art to a song without one, or replaces it. The new cover is checked like an upload’s (a square JPEG or PNG, 1000–6000 px, up to 20 MB) and kept at its full size and at 1536, 640 and 160 px; the cover before stays on the song (list_song_covers) and can be put back in use (use_cover). Videos already made keep the cover they had; quotes, Looks, Canvas loops, music video plans and videos made from then on use the new one. Refused (409, code song_busy) while a video of the song is being made: try again once it is done.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
song_id*stringThe song id
1 <= length <= 120- body
cover_art_url?stringA public https URL of the new cover (or upload the file with the CLI)
urilength <= 2000curl -X POST 'https://kinetune.com/api/v1/songs/string/cover' \
-H 'Content-Type: application/json' \
-d '{}'