Developer docs

List a plan's opening frames

MCP tool
list_music_video_frames
CLI
kinetune plans frames
GET
/api/v1/music-video-plans/{plan_id}/frames

Try it with your own API key: it runs on that key's workspace, so a real key reads your real songs, videos and credits. Reads and quotes only; nothing is charged.

The opening frames drawn for a plan's shots, and the price of one more

Optional, for users who want control over key shots: an opening frame is a picture of the moment a shot opens on (its people, outfit and place, in the video's format), and the video then starts that shot from it, on every model. Returns frames (shot, image_url, thumbnail_url; signed for 7 days), price.credits (what drawing one more costs) and unavailable (shots that can't have one, with the reason: a shot that carries straight on from the one before, or a real person shown with others to Seedance). A frame stays with its shot across drafts while the shot is unchanged, and is never part of the video's quote. 404 when frames aren't offered.

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

Response Body

OK

Example Request
curl -X GET 'https://kinetune.com/api/v1/music-video-plans/string/frames'
Example Response
Empty