Make a video
Developer docs

Keep or leave out a lookbook piece

MCP tool
keep_music_video_lookbook_piece
CLI
kinetune lookbook keep
PATCH/api/v1/music-video-lookbooks/{lookbook_id}/pieces/{piece}

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

Whether a piece goes into the video

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

lookbook_id*string

The lookbook id

Match^lookbook_[0-9a-f-]{36}$
piece*integer

The piece's number (pieces[].index)

Range1 <= value <= 9007199254740991

Request Body

application/json
  1. body
kept*boolean

Response Body

OK

Example Request
curl -X PATCH 'https://kinetune.com/api/v1/music-video-lookbooks/string/pieces/1' \
  -H 'Content-Type: application/json' \
  -d '{
  "kept": true
}'
Example Response
Empty

Redesign a lookbook POST

Redesigns the director's pieces with a note and draws them again (spends credits)

Redraw a lookbook piece POST

Draws one of the director's pieces again, with an optional note (spends credits)