Docs
Dashboard
Image Generation

generate_image

Generate AI images using configured provider (fal.ai, Gemini Imagen, or wiro.ai)

Parameters

ParameterTypeRequiredDefaultDescription
promptstring
Required
Detailed prompt for image generation
aspect_ratiostring
Optional
16:9Ratio: '1:1', '16:9', '9:16', '4:3', '3:4'
stylestring
Optional
Style guidance (e.g., 'minimalist', 'photorealistic')

Example

Generate a hero image:

Request

{
  "prompt": "Modern React development workspace with clean code on monitors, professional tech environment, soft lighting, 4k quality",
  "aspect_ratio": "16:9",
  "style": "photorealistic"
}

Response

{
  "status": "success",
  "image": {
    "url": "https://storage.example.com/generated/hero-abc123.jpg",
    "width": 1920,
    "height": 1080,
    "format": "jpeg"
  },
  "provider": "fal.ai",
  "saved_to_session": true,
  "generation_time": "3.2s"
}

Tips

Best Practices

  • Requires image provider API key in credentials
  • Use image_prompt tool for optimized prompts
  • 16:9 is standard for blog hero images
  • Image is saved to session automatically

Related Tools