Guides

    Render a slideshow as a reel only after overlay text is signed

    convert_slideshow_to_video is a render pass over slides you already paid for. Converting a draft board, or converting before overlays and order are locked, makes an MP4 you will have to re-render.

    Versely Team3 min read

    A carousel and a reel are the same pictures with different delivery. convert_slideshow_to_video renders a slideshow you already built: duration_per_image is one pace for the whole set, transition is how slides move, use_edited_images is whether stamped overlays come along. Forget that flag and you get bare originals — a mute-dead reel. Music and VO URLs must already exist; this tool does not write a track. The slide images were paid at generate time. This is a render. Renders of draft boards are MP4s you will throw away.

    Turn a slideshow into a video is the job. get_slideshow first if you do not have the id. estimate_cost before a long set. Any generate_music / generate_speech you attach is billed separately.

    Fix the board, then render the board

    Fix a slide is cheaper than recutting an MP4. Replace, remove, reorder, then convert. If you stamped copy with add_text_overlay, convert with use_edited_images on purpose. If you convert first "to see the pace," you will convert again after every slide fix, and you will forget the flag once.

    duration_per_image is global. There is no per-slide timing here. If slide three needs to hold, the whole set holds. That constraint is why you do not discover it on a board you still intend to shorten by two tiles.

    The slideshow maker and AI video editor bookend this. Maker is the stills. This is the reel. Editor is if you then need a heavier EDL — still later.

    Order

    1. Sign every slide and the order.
    2. Stamp overlays if the reel must work muted.
    3. Generate music/VO to the known runtime (N × duration_per_image, plus transitions).
    4. Convert once with use_edited_images if you stamped.

    Do not score a 20-second bed for a board that is about to lose two slides.

    FAQ

    Can I edit the MP4 instead of the slideshow?

    You can fight it. The board is the source. Fix slides, re-render.

    Why is my reel missing the captions I stamped?

    use_edited_images was false. The originals rendered. Convert again on the signed board, with the flag.

    Should I convert a 12-slide draft to feel the rhythm?

    Count in a spreadsheet. A billed render of a draft is a movie of indecision. Drop tiles on the board first.

    Is this the same as compose_video_with_overlay?

    Compose mixes arbitrary images and clips. This converts a Versely slideshow object. If your stills live in the slideshow, use this after the object is the object.