veo_video_objects
Add or remove objects in specific video regions using an action and optional mask. Modify existing videos by inserting new objects or deleting unwanted ones.
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 |
|---|---|---|---|
| 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. | |
| video_id | Yes | The video ID from a previous generation result. Use the 'id' field from the video data. | |
| 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 |