veo_video_objects
Insert objects into or remove objects from videos by specifying a region. Precisely modify video areas using optional masks.
Instructions
Insert or remove objects in a video.
Modifies a generated video by adding or removing objects in specific regions.
Use this when:
- You want to add a new object to an existing video
- You need to remove an unwanted object from a video
- You want to precisely modify specific areas of a video
Returns:
Task ID and modified video information including URLs and state.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video_id | Yes | The video ID from a previous generation result. Use the 'id' field from the video data. | |
| action | Yes | 'insert' adds a new object to the video. 'remove' deletes an object from a specific area. | |
| prompt | No | For 'insert': describes what object to add (strongly recommended). For 'remove': describes what to remove (optional). If omitted for insert, the API may reject the request. | |
| image_mask | No | Optional mask image URL where white pixels indicate the region to operate on. Providing a mask improves precision for both insert and remove operations. | |
| callback_url | No | Optional URL to receive a POST callback when the operation completes. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |