Erase region
erase_regionPROJECT-SCOPED: this call acts only on the explicit project_id and returns the project identity with its result. TRULY REMOVE whatever is inside a rectangle — repaints those pixels and reconstructs the background, so the thing is GONE, not covered. Use it for a word, a sign, a sticker, a logo, a person's name on screen, or any object the user wants taken out. SEVERAL marks (a watermark AND a handle AND a caption bar) go in ONE call as regions=[{x,y,w,h,fill?,start?,end?}, ...]. The repaint costs time proportional to the WINDOW you erase, not the video — so pass start/end around when the mark is actually visible and the erase lands in seconds; earlier erases are never redone. x,y = TOP-LEFT corner, w,h = size, all FRACTIONS (0-1) of the SOURCE frame — get them from find_burned_text rather than estimating. fill: 'text' (default — repaints only the letter strokes and keeps the picture behind them; best for captions/handles) or 'box' (repaints the whole rectangle; use for an OBJECT or a solid graphic). start/end (SOURCE seconds) limit it to a window; omit both for the whole video. Reconstruction is excellent for thin text and for anything on a steady shot; a large object on a moving, detailed background can leave a soft patch — the result is measured and reported back to you, so check it before you promise anything.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| h | No | ||
| w | No | ||
| x | No | ||
| y | No | ||
| end | No | ||
| fill | No | ||
| start | No | ||
| regions | No | ||
| project_id | Yes | Required immutable scope for this call. Copy the id from list_projects/open_project/project_state; the active-project pointer is never used to guess. |