Draw an opening frame
- MCP tool
draw_music_video_frame- CLI
kinetune plans draw-frame
/api/v1/music-video-plans/{plan_id}/framesNot 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).
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
plan_id*stringThe plan id (plan_…)
^plan_[0-9a-f-]{36}$application/json- body
shot*integerThe shot's number (shots[].index)
1 <= value <= 9007199254740991credits*integerThe price shown (list_music_video_frames: price.credits)
0 < value <= 9007199254740991curl -X POST 'https://kinetune.com/api/v1/music-video-plans/string/frames' \
-H 'Content-Type: application/json' \
-d '{
"shot": 1,
"credits": 1
}'