Make covers
- MCP tool
make_cover- CLI
kinetune covers make
/api/v1/cover-requestsNot 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).
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
application/json- body
song_id*stringThe song id
1 <= length <= 120count?integerHow many covers, each a different idea (1 to 4, default 1)
1 <= value <= 4style?stringHow it is made (default auto: the director picks)
"auto""portrait""snapshot""film-still""object""place""painted""illustrated""cartoon""anime""collage""3d""graphic""type"vibes?array<>Up to two moods or worlds
items <= 2artist?stringWho 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
"auto""always""never"idea?stringThe user's idea, in their words
length <= 500words?stringWords on the cover, spelled exactly as the song: none (default), title, artist_title
"none""title""artist_title"look?The artist's colours (hex) and typeface for this round
credits*integercredits from quote_cover for this count, as shown to the user
0 < value <= 9007199254740991curl -X POST 'https://kinetune.com/api/v1/cover-requests' \
-H 'Content-Type: application/json' \
-d '{
"song_id": "string",
"credits": 1
}'