/cover-image

name: cover-image
description: "Generate article cover images with 5 dimensions (type, palette, rendering, text, mood). Supports cinematic (2.35:1), widescreen (16:9), and square (1:1) aspects. Use when user asks to 'generate cover image', 'create article cover', or 'make cover'."

Cover Image Generator

Generate elegant cover images for articles with 5-dimensional customization. Supports Chinese text rendering.

Usage

# Auto-select dimensions based on content
/cover-image path/to/article.md

# Quick mode: skip confirmation
/cover-image article.md --quick

# Specify dimensions
/cover-image article.md --type conceptual --palette warm --rendering flat-vector

# WeChat Official Account cover
/cover-image article.md --aspect 2.35:1

# Specify provider
/cover-image article.md --provider qwen

# Use style preset
/cover-image article.md --style tech-dark

# Large font for better visibility
/cover-image article.md --font-size large

# Generate multiple options
/cover-image article.md --n 3

# With reference images (Google/OpenAI only)
/cover-image article.md --ref style-ref.png

# Direct content input
/cover-image --palette mono --aspect 1:1 --quick
[paste content]

Options

| Option | Description | |--------|-------------| | `--type <name>` | hero, conceptual, typography, metaphor, scene, minimal | | `--palette <name>` | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro | | `--rendering <name>` | flat-vector, hand-drawn, painterly, digital, pixel, chalk | | `--text <level>` | none, title-only, title-subtitle, text-rich | | `--mood <level>` | subtle, balanced, bold | | `--font <name>` | clean, handwritten, serif, display | | `--font-size <size>` | small, medium (default), large, xlarge | | `--aspect <ratio>` | 16:9 (default), 2.35:1 (公众号封面), 4:3, 3:2, 1:1, 3:4 | | `--provider <name>` | qwen (default), openai, google | | `--style <preset>` | tech-dark, tech-clean, lifestyle-warm, business-elegant, announcement-bold, minimal-zen, creative-playful, retro-vintage | | `--lang <code>` | Title language (en, zh, ja, etc.) | | `--no-title` | Alias for `--text none` | | `--n <count>` | Number of images to generate (1-4) | | `--quick` | Skip confirmation, use auto-selection | | `--ref <files...>` | Reference images for style/composition guidance |

Providers

| Provider | Model | Text Rendering | Chinese Support | Price | |----------|-------|----------------|-----------------|-------| | `qwen` | qwen-image-plus | Excellent | Native Chinese | 0.2 CNY/image | | `openai` | gpt-image-1 | Good | Limited | ~$0.04/image | | `google` | gemini-2.0-flash-exp | Good | Limited | Free tier available |

Provider Selection Logic

1. `--provider` specified -> use it 2. Chinese title detected -> auto-select `qwen` 3. Reference images provided -> use `google` or `openai` 4. Default -> `qwen`

Qwen-Image (Default)

Best for Chinese text rendering. Native support for Chinese characters.

**API Endpoint**: `https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis`

**Environment Variable**: `DASHSCOPE_API_KEY`

**Supported Sizes**: `1664*928`, `1024*1024`, `928*1664`, `1472*1104`, `1104*1472`

OpenAI

Good for English text and creative designs.

**Environment Variable**: `OPENAI_API_KEY`

**Supported Sizes**: `1024x1024`, `1536x1024`, `1024x1536`

Google

Good for multimodal generation with reference images.

**Environment Variable**: `GOOGLE_API_KEY`

**Supported Sizes**: Various aspect ratios supported

Five Dimensions

| Dimension | Values | Default | |-----------|--------|---------| | **Type** | hero, conceptual, typography, metaphor, scene, minimal | auto | | **Palette** | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro | auto | | **Rendering** | flat-vector, hand-drawn, painterly, digital, pixel, chalk | auto | | **Text** | none, title-only, title-subtitle, text-rich | title-only | | **Mood** | subtle, balanced, bold | balanced | | **Font** | clean, handwritten, serif, display | clean |

Auto-selection rules: [references/auto-selection.md](references/auto-selection.md)

Galleries

**Types**: hero, conceptual, typography, metaphor, scene, minimal -> Details: [references/types.md](references/types.md)

**Palettes**: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro -> Details: [references/palettes/](references/palettes/)

**Renderings**: flat-vector, hand-drawn, painterly, digital, pixel, chalk -> Details: [references/renderings/](references/renderings/)

**Text Levels**: none (pure visual) | title-only (default) | title-subtitle | text-rich (with tags) -> Details: [references/dimensions/text.md](references/dimensions/text.md)

**Mood Levels**: subtle (low contrast) | balanced (default) | bold (high contrast) -> Details: [references/dimensions/mood.md](references/dimensions/mood.md)

**Fonts**: clean (sans-serif) | handwritten | serif | display (bold decorative) -> Details: [references/dimensions/font.md](references/dimensions/font.md)

File Structure

Output directory per `default_output_dir` preference:

• `same-dir`: `{article-dir}/`
• `imgs-subdir`: `{article-dir}/imgs/`
• `independent` (default): `cover-image/{topic-slug}/`

<output-dir>/
├── source-{slug}.{ext}    # Source files
├── refs/                  # Reference images (if provided)
│   ├── ref-01-{slug}.{ext}
│   └── ref-01-{slug}.md   # Description file
├── prompts/cover.md       # Generation prompt
└── cover.png              # Output image

**Slug**: 2-4 words, kebab-case. Conflict: append `-YYYYMMDD-HHMMSS`

Workflow

Progress Checklist

Cover Image Progress:
- [ ] Step 1: Analyze content + save refs + determine output dir
- [ ] Step 2: Confirm options (6 dimensions + provider) unless --quick
- [ ] Step 3: Create prompt
- [ ] Step 4: Generate image
- [ ] Step 5: Resize for platform (if needed)
- [ ] Step 6: Completion report

Step 1: Analyze Content

1. **Save reference images** (if provided) -> [references/workflow/refe