---
name: gsk-image-generation
version: 1.0.0
description: Generate images using AI models. Supports text-to-image and image editing.
metadata:
  category: general
  requires:
    bins:
    - gsk
  cliHelp: gsk img --help
---

# gsk-image-generation

**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.

Generate images using AI models. Supports text-to-image and image editing.

## Usage

```bash
gsk img [options]
```

**Aliases:** `image_generation`, `img`

## Flags

| Flag | Required | Description |
|------|----------|-------------|
| `-m`, `--model` | No | Default model: use nano-banana-2 fal-ai/gpt-image-1.5: GPT Image 1.5 - Supports text-to-image and image editing with multi-image input. nano-banana-pro: [GEMINI NANO BANANA PRO] State of the Art (SOTA) for both generation and image editing. Multi-image fusion: Combine different images into one seamless new visual. Character & style consistency: Maintain the same subject or visual style across multiple generations. Conversational editing: Edit images with simple, natural language instructions. Perfect for creative use cases, marketing, training, advertising. Supports up to 14 images as reference input. Supports high resolution output up to 2K/4K. nano-banana-2: [GEMINI NANO BANANA 2] Gemini 3.1 Flash Image. Fast and efficient with advanced reasoning. Multi-image fusion with up to 14 reference images. Supports 0.5K/1K/2K/4K resolution. Google Search grounding for real-time data. Best for high-volume, speed-optimized workflows. imagen4: A latest model for generating high quality image, upgrade from Imagen 3. currently in preview mode.recraft-v3: A model for generating realistic image.fal-ai/bytedance/seedream/v5/lite: Bytedance Seedream v5 Lite model for text-to-image, image-to-image (single and multiple image editing) generation with native 2K resolution and excellent text layout.fal-ai/flux-2: Flux 2 model for text-to-image and image editing with enhanced realism, crisp text generation, and native editing capabilities. Fast processing with flexible aspect ratios. Supports up to 3 images for edit mode.fal-ai/flux-2-pro: Flux 2 Pro model - higher quality version of Flux 2 with professional-grade output. Enhanced realism, superior text generation, and advanced editing capabilities. Ideal for high-quality realistic images and complex editing tasks.fal-ai/z-image/turbo: Z-Image Turbo model optimized for speed without sacrificing quality. Supports both text-to-image and image-to-image modes. Perfect for quick iterations, bulk generation, style transfer, and cost-effective projects.ideogram/V_3: [FACE CONSISTENCY] Character reference specialist with superior facial feature preservation, character consistency across styles/poses/scenes, natural language understanding, excellent text rendering.qwen-image: [CHINESE POSTER SPECIALIST] Outstanding Chinese poster creation, superior Chinese text rendering, cultural context mastery, exceptional Chinese understanding, cost efficient.bbox-segment: A model for extracting subjects from images based on bbox region.fal-bria-rmbg: A model specialized for remove background from image. Should prioritize this tool if the user wants to remove background from image. fal-ai/recraft-clarity-upscale: A model specialized for upscale image. fal-ai/image-editing/text-removal: A specialized model for removing text and watermarks from images. Automatically detects and removes text while preserving the background and other visual elements. Use when users want to clean images, remove watermarks, or eliminate text overlays. flux-pro/outpaint: A model specialized for expand image to a specific aspect ratio.  (string, one of: fal-ai/gpt-image-1.5, imagen4, recraft-v3, fal-ai/bytedance/seedream/v5/lite, fal-ai/flux-2, fal-ai/flux-2-pro, fal-ai/z-image/turbo, ideogram/V_3, qwen-image, bbox-segment, fal-bria-rmbg, fal-ai/recraft-clarity-upscale, fal-ai/image-editing/text-removal, flux-pro/outpaint, nano-banana-pro, nano-banana-2) |
| `<query>` (positional) | Yes | Detailed description of the image to generate. The prompt should be in English.However, any specific text that should appear within the image does not need to be translated.(e.g., 'A futuristic cityscape with flying cars and neon lights at night'). (string) |
| `--bbox` | No | BBox of the target object, for bbox segmentation modelFormat: [x1, y1, x2, y2], x1 and y1 are the top-left corner coordinates, x2 and y2 are the bottom-right corner coordinates. (array) |
| `-i`, `--image_urls` | No | The URLs of the images to use as a reference for the image generation or editing. (default is [], if the task is based on one or more reference images, it is required) (array) |
| `-r`, `--aspect_ratio` | No | The aspect ratio of the image to generate. (string, one of: 1:1, 4:3, 16:9, 9:16, 3:4, 2:3, 3:2, auto) |
| `-s`, `--image_size` | No | Image size resolution. Default is auto. (string, one of: auto, 0.5k, 1k, 2k, 3k, 4k) |

## Local File Support

Parameters that accept URLs (`--image_urls`) also accept local file paths. The CLI automatically uploads local files before sending to the API.

## Output File

Use `-o <path>` / `--output-file <path>` to download the generated result directly to a local file.

## See Also

- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags