Design a music video lookbook
- MCP tool
design_music_video_shoot- CLI
kinetune lookbook design
/api/v1/music-video-lookbooksNot sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.
The director designs the outfits, places and props the brief leaves to it as pictures, before the shot list
Optional, before the shot list (plan_music_video). Free to design (a limited number an hour), about a minute: returns a lookbook whose pieces are the brief's own kit pieces (yours, used as they are) and the director's designs (an outfit drawn on the artist, a place drawn empty, a prop alone), not drawn yet. price.draw.credits is what drawing them costs: tell the user, then render_music_video_lookbook after their go. Same brief as plan_music_video. 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
application/json- body
song_id*stringThe song; its artist performs the video and needs photos (add_artist_photos)
1 <= length <= 120model?"one-take"The music video model: one-take (default; MiniMax H3 Max, the artist lip-synced in shots cut between the song's lines). get_options lists the models with the categories, styles, formats, takes and length each makes
"one-take""one-take"category?stringperformance (default), intercut, cinematic, story or surreal
"performance""performance""intercut""cinematic""story""surreal"style?stringOptional look: natural, film, golden-hour, neon-night, noir, vintage or dreamy; omitted, the director picks one from the cover
"natural""film""golden-hour""neon-night""noir""vintage""dreamy"aspect_ratio?string"9:16" (default), "16:9" or "1:1"
"9:16""9:16""16:9""1:1"trim?Only this section of the song (15 seconds to 10 minutes); omitted, the whole song (15 seconds to 10 minutes long). Best: a part from get_song_analysis (parts[]: its start and end never cut a word)
direction?stringOptional notes for the director (a place, an era, a story idea, a mood). Mention kit pieces by @handle (list_kit): "@nina-kazora in the @blue-set on the @rooftop, the @chrome-mic in hand"; a mentioned piece is used exactly as it is and the director designs the rest. An unknown handle answers 400
length <= 2000cast?The two photos the artist is kept from: face_photo_id (a sharp face, mouth visible) and outfit_photo_id (the outfit and body worn throughout); either left out, the director picks it. One photo can be both; hidden photos (add_artist_photos hidden) work too
scenes?Where it is set besides the places the direction mentions from the kit: {"mode":"invent"} (default: the director imagines the others) or {"mode":"stock"} (it finds a real stock photo of each place it writes, empty of people, and the artist is put into it), up to the model's kit.places in all
{
"mode": "invent"
}takes?stringHow the shots meet: "cuts" (default: shots meet between the song's lines like an edit, with a cut or the transition the director picks at each join: dissolve, dip to black, flash or whip; ask for them, or for none, in direction) or "continuous" (the director may carry a shot on into the next through a picture drawn of the moment they meet, priced per picture; the quote before a plan counts every join, the plan's quote only the ones it draws)
"cuts""cuts""continuous"curl -X POST 'https://kinetune.com/api/v1/music-video-lookbooks' \
-H 'Content-Type: application/json' \
-d '{
"song_id": "string"
}'