Generate an image with Antigravity
antigravity_imageGenerate an image from a text description using a Gemini AI model, save it, and return the file path with format and size.
Instructions
Generate an image with Antigravity (Gemini image model via agy CLI).
Drives agy to produce a raster image on your existing AI Pro quota, saves it, and returns the absolute file path plus its real format and byte size. The host can then read the path to view the image.
agy picks the image format itself (JPEG for photo-like images, PNG for flat graphics), so the returned path's extension is corrected to match the actual bytes (a requested out.png may come back as out.jpg). Runs a normal, unsandboxed agy session — same privileges/caveats as the other tools (see the module SECURITY note).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| watch | No | If true, open the live "watch" window that streams agy's steps and shows the finished image inline (same return value, best-effort). Default false. | |
| prompt | Yes | Description of the image to generate. | |
| timeout_s | No | Max seconds to wait for agy to complete. Default 240 (image generation is slower than text). | |
| workspace | No | Working directory for the conversation. Defaults to cwd. | |
| output_path | No | Where to save. Absolute, or relative to `workspace`. If omitted, a timestamped name under `workspace` is used. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |