image-gen

# Image Generation Skill

Generate and edit website images using Gemini Native Image Generation.

## ⚠️ Critical: SDK Migration Required

**IMPORTANT**: The `@google/generative-ai` package is deprecated as of November 30, 2025. All new projects must use `@google/genai`.

**Migration Required**:
```typescript
// ❌ OLD (deprecated, support ended Nov 30, 2025)
import { GoogleGenerativeAI } from "@google/generative-ai";
const genAI = new GoogleGenerativeAI(API_KEY);

// ✅ NEW (required)
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: API_KEY });
```

**Source**: [GitHub Repository Migration Notice](https://github.com/google-gemini/deprecated-generative-ai-js)

## Models

| Model | ID | Status | Best For |
|-------|-----|--------|----------|
| **Gemini 3 Pro Image** | `gemini-3-pro-image-preview` | Preview (Nov 20, 2025) | 4K, complex prompts, text |
| **Gemini 2.5 Flash Image** | `gemini-2.5-flash-image` | GA (Oct 2, 2025) | Fast iteration, general use |
| **Imagen 4.0** | `imagen-4.0-generate-001` | GA (Aug 14, 2025) | Alternative platform |

**Deprecated Models** (do not use):
- `gemini-2.0-flash-exp-image-generation` - Shut down Nov 11, 2025
- `gemini-2.0-flash-preview-image-generation` - Shut down Nov 11, 2025
- `gemini-2.5-flash-image-preview` - Scheduled shutdown Jan 15, 2026

**Source**: [Google AI Changelog](https://ai.google.dev/gemini-api/docs/changelog)

## Capabilities

| Feature | Supported |
|---------|-----------|
| Generate from text | ✅ |
| Edit existing images | ✅ |
| Change aspect ratio | ✅ |
| Widen/extend images | ✅ |
| Style transfer | ✅ |
| Change colours | ✅ |
| Add/remove elements | ✅ |
| Text in images | ✅ (legible!) |
| Multiple reference images | ✅ (up to 14: max 5 humans, 9 objects) |
| 4K resolution | ✅ (Pro only) |

**Note**: Exceeding 5 human reference images causes unpredictable character consistency. Keep human images ≤ 5 for reliable results.

## Aspect Ratios

```
1:1   | 2:3  | 3:2  | 3:4  | 4:3
4:5