DocsToolsImage Generation

Image Generation

Tool set: image_generationDefault: DisabledRequires: API key

Generate images from text prompts using AI. Your agent can create illustrations, diagrams, logos, and more — all saved automatically to the Asset Library. Nano Banana 2 is the default model; Imagen 4 is deprecated and shuts down August 17, 2026.

Setup

Enable Image Generation in your agent's Settings. Then add a provider credential:

ProviderCredentialNotes
Gemini / Nano BananaGemini API keyDefault Nano Banana 2 plus Nano Banana Pro, supports image input and edits
OpenAIOpenAI API keyDirect GPT Image 2 text-to-image; separately metered API access, not a ChatGPT subscription
OpenRouterOpenRouter API keyCurated image models with optional reference-image input
Nano BananaNano Banana API keyMultiple model tiers (generate, generate-2, generate-pro)

You can select your preferred provider and model in the chat interface using the model selector.

Tools

ToolDescription
generate_imageGenerate an image from a text prompt and save it to assets
list_assetsList all generated images and files in the asset library

Parameters

generate_image

ParameterTypeRequired
promptstringYes
namestringYes
provider"gemini" | "openai" | "openrouter" | "nano_banana"No
widthnumberNo (default: 1024)
heightnumberNo (default: 1024)
folder_idstringNo
input_asset_idstringNo; only used by models with image input support

Image Models

ModelStatusNotes
gemini:gemini-3.1-flash-imageDefaultStable Nano Banana 2, supports image input and edits
gemini:gemini-3.1-flash-lite-imageAvailableStable Nano Banana 2 Lite for low-latency 1K generation and editing
gemini:gemini-3-pro-imageAvailableStable Nano Banana Pro for higher-fidelity image work
openai:gpt-image-2AvailableDirect OpenAI text-to-image; reference input is disabled in this flow
openrouter:openai/gpt-image-2AvailableGPT Image 2 through OpenRouter with reference-image input
openrouter:bytedance-seed/seedream-4.5AvailableSeedream 4.5 through OpenRouter
openrouter:black-forest-labs/flux.2-proAvailableFLUX.2 Pro through OpenRouter
openrouter:recraft/recraft-v4.1AvailableRecraft V4.1 through OpenRouter
nano_banana:generate-2AvailableThird-party Nano Banana API model with custom resolution
nano_banana:generate-proAvailableThird-party Nano Banana API high-resolution model
gemini:imagen-4.0-generate-001DeprecatedImagen 4 shuts down August 17, 2026
gemini:imagen-4.0-fast-generate-001DeprecatedImagen 4 Fast shuts down August 17, 2026
gemini:imagen-4.0-ultra-generate-001DeprecatedImagen 4 Ultra shuts down August 17, 2026
nano_banana:generateLegacyOlder Nano Banana API model

Supported Aspect Ratios

The selected aspect ratio is forwarded to native Gemini models and to curated OpenRouter models that expose aspect-ratio control. Direct GPT Image 2 uses the nearest valid pixel dimensions.

Example

User: "Generate a logo for my coffee shop called Bean There"

Agent: Generates image → saves to assets → returns preview with download link

Integration

Generated images are stored in the Asset Library with full metadata (prompt, provider, model, dimensions). Combine with Automations for workflows like "when a task is created → generate a thumbnail."