Developer docs

Draw an opening frame

MCP tool
draw_music_video_frame
CLI
kinetune plans draw-frame
POST/api/v1/music-video-plans/{plan_id}/frames

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

Draws the picture a planned shot opens on (spends credits)

Paid per picture: tell the user the price (list_music_video_frames: price.credits) and draw only after their go, then show them the picture (image_url). Drawing a shot again replaces its frame (the earlier picture is gone) for the same price. Good for the shots that matter most (the opening, the hook); the others are made from their references as usual. credits is the price the user agreed to; another price answers 409 with the current one. Takes about a minute; nothing is charged if it fails. 400 with the reason for a shot that can't have one (list_music_video_frames: unavailable). Then quote_music_video and create_music_video with the plan_id as usual. Needs an active plan (402 plan_required without one; get_account: plan.active) and room in its storage (402 storage_full when it would not fit; get_account: storage).

headerAuthorizationBearer <token>

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

plan_id*string

The plan id (plan_…)

Match^plan_[0-9a-f-]{36}$
application/json
  1. body
shot*integer

The shot's number (shots[].index)

Range1 <= value <= 9007199254740991
credits*integer

The price shown (list_music_video_frames: price.credits)

Range0 < value <= 9007199254740991

Response Body

OK

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