Developer docs

Make covers

MCP tool
make_cover
CLI
kinetune covers make
POST/api/v1/cover-requests

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

Kinetune’s cover art director makes 1 to 4 covers for a song, each a different idea

The director reads the song (its meaning, never a lyric drawn literally), the user's choices and the artist's character, and the image model draws each cover; each is checked (no letters in the picture, reads as a thumbnail) and kept on the song (list_song_covers) as it is drawn, in about a minute. Only covers that pass are charged; the song keeps its cover until the user picks one (use_cover). style: how it is made (auto: the director picks); vibes: up to 2 moods (dark, sad, hood, luxury…); artist: auto (the director decides), always (needs their character), never; when the song is about two people (a love song, a duet) the director may show the other person beside the artist, partly or fully, always an invented person, never a real likeness (never with artist never); idea: the user's own words; words: none, title, or artist_title, lettered into the cover in the artist's typeface and read back letter by letter, always spelled as the song (the type style needs words); look: overrides the artist's colours and typeface. Ask the user for their choices rather than guessing, and quote first (quote_cover): credits must match. Needs a paid plan (402 plan_required) and an analysed song (409 song_not_ready); one round per song at a time (409 covers_in_progress).

headerAuthorizationBearer <token>

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

application/json
  1. body
song_id*string

The song id

Length1 <= length <= 120
count?integer

How many covers, each a different idea (1 to 4, default 1)

Range1 <= value <= 4
style?string

How it is made (default auto: the director picks)

Value in"auto""portrait""snapshot""film-still""object""place""painted""illustrated""cartoon""anime""collage""3d""graphic""type"
vibes?array<>

Up to two moods or worlds

Itemsitems <= 2
artist?string

Who is on it: auto (the director decides), always (the artist), never (no one). With the artist, a song about two people may also show the other person, always invented

Value in"auto""always""never"
idea?string

The user's idea, in their words

Lengthlength <= 500
words?string

Words on the cover, spelled exactly as the song: none (default), title, artist_title

Value in"none""title""artist_title"
look?

The artist's colours (hex) and typeface for this round

credits*integer

credits from quote_cover for this count, as shown to the user

Range0 < value <= 9007199254740991

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/cover-requests' \
  -H 'Content-Type: application/json' \
  -d '{
  "song_id": "string",
  "credits": 1
}'
Example Response
Empty