返回 Skill 列表
extension
分类: 内容与媒体无需 API Key

genai-image

通过CLI使用Google GenAI Nano Banana Pro模型生成图像。当用户要求创建图像、生成图片、制作AI艺术、进行图像到图像的转换、将人物置于场景中或创建角色变体时使用。

person作者: jakexiaohubgithub

GenAI Image Generation Skill

Generate high-quality images using the genai-cli image command with Nano Banana Pro.

Quick Start

# Basic image generation
uv run genai-cli image "your prompt here" --aspect 16:9

# Image-to-image (use existing image as reference)
uv run genai-cli image "place this person in a datacenter" --input ./photo.png --aspect 16:9

# With all options
uv run genai-cli image "robot in tuxedo" --aspect 9:16 --variations 3 --quality 90

CLI Reference

uv run genai-cli image [OPTIONS] PROMPT

Options:
  --aspect, -a      Aspect ratio (1:1, 9:16, 16:9, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9)
  --resolution, -r  Resolution: 1K or 4K
  --variations, -v  Number of images (1-10)
  --quality, -q     Output quality (0-100)
  --guidance, -g    Prompt adherence (0-20)
  --enhance         Auto-improve prompt
  --format, -f      Output format: png, jpeg, webp
  --output, -o      Output directory (default: ./genai_outputs/)
  --input, -i       Input image for image-to-image generation
  --json            Output as JSON

Image-to-Image Generation

Use an existing image as a reference to generate new images:

# Place a person in a new scene
uv run genai-cli image "Place this person in a modern datacenter with server racks and blue LED lights" \
  --input ./person.png \
  --aspect 16:9

# Transform a photo
uv run genai-cli image "Convert to anime style, vibrant colors" \
  --input ./photo.jpg

# Add elements to an existing image
uv run genai-cli image "Add a sunset background and dramatic lighting" \
  --input ./portrait.png

Use cases for image-to-image:

  • Place people in new environments/scenes
  • Style transfer (photorealistic to anime, etc.)
  • Add or modify elements in existing images
  • Create variations of a reference image
  • Professional headshots in different settings

Supported Aspect Ratios

| Ratio | Use Case | |-------|----------| | 1:1 | Square, social media | | 9:16 | Vertical, mobile, stories | | 16:9 | Horizontal, widescreen | | 4:3 | Standard photo | | 3:4 | Portrait | | 3:2 | Classic photo | | 2:3 | Portrait photo | | 4:5 | Instagram portrait | | 5:4 | Large format | | 21:9 | Ultrawide, cinematic |

Examples

Basic Generation

uv run genai-cli image "A sunset over mountains" --aspect 16:9

High Quality Portrait

uv run genai-cli image "Professional headshot, studio lighting" --aspect 3:4 --quality 95

Batch Generation

uv run genai-cli image "Abstract art, vibrant colors" --variations 5 --aspect 1:1

Person in Datacenter (Image-to-Image)

uv run genai-cli image "Place this person in a modern datacenter environment with server racks, blue LED lights, professional IT atmosphere" \
  --input ./team_photo.png \
  --aspect 16:9

With JSON Output (for automation)

uv run genai-cli image "Product photo" --json

Output

Images are saved to ./genai_outputs/ by default:

  • genai_image_001.png
  • genai_image_002.png (if variations > 1)
  • etc.

Prompt Tips

  1. Be specific: "A robot in a black tuxedo with bow tie" > "A robot in a suit"
  2. Include lighting: "Cinematic dramatic lighting"
  3. Specify style: "Photorealistic", "Cinematic", "Film noir"
  4. Add text: "Bold text reads: 'YOUR TEXT HERE'"
  5. For image-to-image: Describe what you want to happen to/with the input image

Prerequisites

API key must be configured:

uv run genai-cli auth set-key