Change a slide, not the whole slideshow: add_images_to_slideshow is a delta
Edit my slideshow is one agent job: add, remove, replace, or reorder. Regenerating the carousel, or converting to video first, is a different job.
Change a slide, not the whole slideshow. Edit my slideshow is a delta on a board you already made. Primary tool add_images_to_slideshow appends URLs you provide. Supporting tools remove a slide, replace one, reorder, or get_slideshow so the card actually appears. Using a brand-new slideshow generate because slide 3 is wrong, or converting to video before the order is signed, spends image generations and a render on a board you could have patched.
The agent pulls your most recent slideshow if you do not pass an id. "Add these two photos to the end." "Delete slide 3." "Regenerate slide 4 with a sunset instead." "Move slide 5 to the front." That is the job. Fix a slide in a slideshow is the editing-surface twin.
Patch, don't mint a second carousel
Generate a slideshow from a prompt and turn photos into a slideshow are create. They mint a board. Edit is after. A new generate will not reliably clone the seven slides you liked. You will pay for eight new images to fix one.
Adding your own photos, reordering, and removing do not cost generation credits. Replacing a slide with a freshly generated image is priced like a new image generation (refunded on failure). That split is the whole credit story. Do not "just remake it" when the expensive line is one replacement.
Convert is later. Turn a slideshow into a video renders the current board. Overlay text is its own stamp. Edit the slide, stamp if you need copy, then convert. An MP4 of the wrong order is a process you will run again.
Append order is the array you pass, at the next free order_index. It will not insert between slide 2 and 3 unless you reorder after. If the new picture is a URL you already have, send the URL. If you needed a generated sunset on slide 4, that is replace — one image generation, refunded on failure — not eight.
One change per ask is fine
You can stack changes in one turn if you name them. Vague "fix the slideshow" is how you get a replace you did not want. Name the index. Name whether the new image is an upload (append, no generate) or a generated replacement (a real image bill).
FAQ
Should I generate a new slideshow when one slide is wrong?
No. Replace or remove that slide. A full remint is N image generations for a one-slide problem.
Does adding my own photos cost generation credits?
No. Append and reorder and delete do not. A generated replacement does. Say which you mean.
Can I convert first and recut the video?
You can. You will recut an MP4 instead of moving slide 5. Edit the board; convert the signed set.
Why call get_slideshow?
It is the only way the slideshow card with thumbnails appears in chat. Describing the board in prose does not show it. Fetch, then edit.