# Crop video (`crop_video`)
> Reframes a video to a social aspect ratio, for example vertical 9:16 for Shorts, Reels, or TikTok. Many ratios are supported.
- 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
"Make a vertical version of this for TikTok"

## Parameters
- `video_id` (string, required): The video's guid.
- `aspect_ratio` (string, required): Target aspect ratio — one of: 16:9, 9:16, 1:1, 4:5, 5:4, 4:3, 3:4, 2:3, 3:2, 2:1, 1:2, 21:9, 9:21, 32:9.
- `object_fit` (string): 'cover' = center-crop to fill the new frame; 'contain' = letterbox. Omit for the editor default (cover).
- `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
Crop/reframe a video to a social aspect ratio (e.g. vertical 9:16 for Shorts, TikTok, Reels). aspect_ratio must be one of: 16:9, 9:16, 1:1, 4:5, 5:4, 4:3, 3:4, 2:3, 3:2, 2:1, 1:2, 21:9, 9:21, 32:9. object_fit 'cover' center-crops to fill (default), 'contain' letterboxes instead. 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.


## Used in these prompts

- Clip the best moment for social (Marketing): "Find the strongest 45 seconds in my talk [link], trim to just that moment, reframe it vertical for Reels and TikTok, and add a bold text overlay of the key quote."
- 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/crop-video
