Plan a music video
plan_music_videoThe director's treatment and shots for a music video, before anything is charged. Free (a limited number an hour). Takes about a minute. Returns a plan: the concept, the face and outfit photos, and one shot per 15-second clip with its lyrics. Show it to the user, rewrite it with revise until they like it, then quote_music_video and create_music_video with its plan_id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cast | No | 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 | |
| trim | No | Only this section of the song (15 seconds to 10 minutes); omitted, the whole song (15 seconds to 10 minutes long) | |
| model | No | The music video model: one-take (default; one continuous, lip-synced take of the artist). get_options lists the models with the categories, styles, formats and length each makes | one-take |
| style | No | Optional look: natural, film, golden-hour, neon-night, noir, vintage or dreamy; omitted, the director picks one from the cover | |
| revise | No | Rewrite an earlier plan of this song: {"plan_id":"plan_…","note":"what to change"} (the next draft) | |
| scenes | No | 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 | |
| song_id | Yes | The song; its artist performs the video and needs photos (add_artist_photos) | |
| category | No | performance (default), intercut, cinematic, story or surreal | performance |
| direction | No | Optional 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 | |
| lookbook_id | No | A lookbook (design_music_video_shoot) whose kept, drawn pieces the video uses like the kit pieces the direction mentions; its idea leads the director | |
| aspect_ratio | No | "9:16" (default), "16:9" or "1:1" | 9:16 |