# Add zoom effect (`add_zoom`)
> Adds a punch-in or Ken Burns zoom, set by a magnification above 1, a focus point in canvas pixels, and a time window.
- Area: [Studio editing](https://mcp.dadan.io/tools/studio-editing.md)
- Access: Makes changes; has an irreversible path, so clients ask to confirm (the explicit overwrite_original:true path irreversibly replaces the original's render)
- AI credits: yes
- Available on read-only connections: no

## Example prompt
"Add a punch-in zoom around the one-minute mark"

## Parameters
- `video_id` (string, required): The video's guid.
- `zoom` (number): Magnification, greater than 1 (1.5 = 150%; typical 1.1–3).
- `center_x` (number): Focus center X in canvas pixels (e.g. 960 on a 1920-wide frame).
- `center_y` (number): Focus center Y in canvas pixels (e.g. 540 on a 1080-tall frame).
- `start_seconds` (number): When the zoom starts, in seconds.
- `end_seconds` (number): When the zoom ends, in seconds.
- `zooms` (object[]): Several zoom keyframes: {zoom, center_x, center_y, start_seconds, end_seconds} each. Overrides the single zoom.
- `overwrite_original` (boolean): true = OVERWRITE the original video's render in place (irreversible). Default false = renders a NEW copy, original untouched.

## Description for AI assistants
Add a punch-in / Ken Burns zoom to a video. zoom is the magnification (> 1; 1.5 = 150%, typical 1.1–3); center_x/center_y are the FOCUS CENTER in canvas pixels (NOT a box origin) — OMIT them to zoom on the frame center, which is the reliable default: you cannot see the video, so never guess coordinates for a specific on-screen object (ask the user, using get_video's width/height when available — it may be null). start_seconds/end_seconds (SECONDS) bound the zoom window. Several keyframes via zooms. overwrite_original default false = renders a NEW copy, original untouched; true OVERWRITES the original's render. Returns a processing job — poll get_job_status; rendering takes a while.


## Known limitations

- Coordinates are caller-supplied; the model cannot see video frames. Omitting center_x/center_y produces a frame-centre punch-in.


## Used in these prompts

- Spin a long video into a Short (Creators & Social): "Pull the best 30 seconds from [link], reframe it vertical, add a punch-in zoom at the key moment, and lay background music from [music link] under it."
Canonical page: https://mcp.dadan.io/tools/add-zoom
