Skip to main content
Ask explicitly for Ditto to edit a video you already have from your agent chat. Ditto replaces characters, props and backgrounds using reference images or avatars, or re-renders the whole video in a style. Generic replacement requests continue to use the regular canvas workflow. For example: “Use Ditto to put Loopy in place of the person in this video.” Your agent uploads the video, shows a review with the credit estimate, then generates. The result stays in chat with Download video. This page covers Ditto in chat. Ditto covers Ditto in Melius, and the tool reference lists every Ditto tool.

Replace people, props and backgrounds

Attach the source video (MP4 or MOV) and an image for each replacement, or name an avatar. Your agent finds your team’s avatars and Melius avatars with ditto_avatar_list, so you can say “swap the presenter for Sam” without uploading an image. One request can hold up to 30 replacements. Ditto applies them together in one generation, with one price and one output video. Your agent keeps every item in the order you gave it. It never drops an item or splits the request into several paid runs.
  • Characters — Ditto picks the main person, or distinct people in the order of your images when you replace several. Describe a person to choose who changes: “replace the woman on the left.”
  • Props and backgrounds — describe what each image replaces when you replace two or more props, or two or more backgrounds.
  • Direction — add instructions that apply to the whole edit, such as “keep the lighting warm.”
Ditto uses the full video and keeps its original audio unless you ask for a clip or no sound.

Restyle a video

Ask for a style by name, or ask your agent to show the styles: “Restyle this clip as claymation.” ditto_style_list lists Melius styles and your team’s own. A style transfer re-renders the whole video, so it takes no replacements. To make a new style from your own images, attach up to six of them and ask your agent to save them as a style. The style belongs to your whole team, and you can use it right away.

Review and generate

Before generating, your agent shows the source, every replacement and what it targets, the selected range, resolution, audio and the total credits. An estimate-only request stops here. For an edit request, your agent continues to generation in the same turn, using your client’s native tool approval. If the video can’t be made as requested, for example because the source is too long, the review explains why. Your agent asks only for the change it needs.

Follow and download

In MCP Apps clients, the card opened by an accepted edit tracks it through preparing, rendering and finalizing, then becomes the finished player. Text-only clients poll the same edit and return media links. Only a ready video can be downloaded, and checking an edit never starts it again. A failed edit stops there. Asking again starts a new paid edit. When Ditto rendered the video but couldn’t finish it, your agent can retry the finishing step without paying for another render. Your Ditto videos also appear in History in Ditto, and your agent can find them through Cast history.

Usage and credits

Ditto uses your team’s credits and follows the same MCP usage policy as the other tools. Checking progress has the same counting exemption as other generation polling tools.
Last modified on November 16, 2026