Developer docs

Draw a lookbook

MCP tool
render_music_video_lookbook
CLI
kinetune lookbook render
POST/api/v1/music-video-lookbooks/{lookbook_id}/render

Not sent from the docs: it spends credits. Run it with curl, the CLI or its MCP tool.

Draws the pieces not drawn yet (spends credits)

credits is the price the user agreed to (price.draw.credits); a different price answers 409 with the current one. The credits are held, then charged as pictures are drawn; one that fails isn't charged. Poll get_music_video_lookbook until status is ready.

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}$

Request Body

application/json
  1. body
credits*integer

The price shown (price.draw.credits)

Range0 < value <= 9007199254740991

Response Body

OK

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