Developer docs

Use a cover

MCP tool
use_cover
CLI
kinetune covers use
POST/api/v1/songs/{song_id}/covers/{cover_id}/use

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

Puts one of the song’s covers in use

Everything made from now on uses it; videos already made keep theirs. A made cover's colours and typeface become the artist's look for their next covers. Refused (409 song_busy) while a video of the song is being made. No plan needed.

headerAuthorizationBearer <token>

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

song_id*string

The song id

Length1 <= length <= 120
cover_id*string

The cover id (cover_…)

Length1 <= length
application/json
  1. body

Response Body

OK

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