Image Generation
Use the native image_generate tool when the user asks you to create, generate,
render, edit, restyle, or make a deliverable raster image.
Do not use image_generate to inspect or describe an existing image. Use
vision_analyze for image understanding.
Workflow
- Call
image_generate with action: "list" if you need to check whether an
image provider is configured or explain missing auth/model setup.
- For generation, pass a clear
prompt and optional aspectRatio, size,
quality, and count. The native provider layer supports GPT Image 2,
Nano Banana 2, Grok Imagine, and FLUX.2 when those providers are configured.
- For image-to-image edits, pass reference media paths in the
image_generate image or images arguments. Paths may come from
/workspace, /discord-media-cache, /uploaded-media-cache, or safe
current-turn Discord CDN URLs.
- Treat provider
warnings as user-relevant when they change requested
options such as quality, size, aspect ratio, or count.
- Return the generated artifact directly in the final response. The tool owns
provider auth, provider quirks, file persistence, and media delivery paths.
Keep prompts concrete and visual. Include subject, composition, style, colors,
format, and any text that must appear in the image.
1---2name: image-generation3description: Generate or edit raster images with the native image_generate tool.4---56# Image Generation78Use the native `image_generate` tool when the user asks you to create, generate,9render, edit, restyle, or make a deliverable raster image.1011Do not use `image_generate` to inspect or describe an existing image. Use12`vision_analyze` for image understanding.1314## Workflow15161. Call `image_generate` with `action: "list"` if you need to check whether an17 image provider is configured or explain missing auth/model setup.182. For generation, pass a clear `prompt` and optional `aspectRatio`, `size`,19 `quality`, and `count`. The native provider layer supports GPT Image 2,20 Nano Banana 2, Grok Imagine, and FLUX.2 when those providers are configured.213. For image-to-image edits, pass reference media paths in the22 `image_generate` `image` or `images` arguments. Paths may come from23 `/workspace`, `/discord-media-cache`, `/uploaded-media-cache`, or safe24 current-turn Discord CDN URLs.254. Treat provider `warnings` as user-relevant when they change requested26 options such as quality, size, aspect ratio, or count.275. Return the generated artifact directly in the final response. The tool owns28 provider auth, provider quirks, file persistence, and media delivery paths.2930Keep prompts concrete and visual. Include subject, composition, style, colors,31format, and any text that must appear in the image.