Developer docs

Redraw a cover

MCP tool
redraw_cover
CLI
kinetune covers redraw
POST/api/v1/cover-requests/{request_id}/draw

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

Draws one cover of a round again with the user’s note

Keeps the idea and changes what the note asks ("warmer, the moon bigger"). A new round of one cover; the cover it came from stays on the song. credits: redraw_credits from quote_cover, as shown to the user. Needs a paid plan.

headerAuthorizationBearer <token>

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

request_id*string

The round the cover came from (coverreq_…)

Length1 <= length
application/json
  1. body
cover_id*string

The cover to redraw (cover_…)

Length1 <= length
note*string

What to change, in the user's words

Length1 <= length <= 500
credits*integer

redraw_credits from quote_cover

Range0 < value <= 9007199254740991

Response Body

OK

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