WeChat Cover Image Generator

Generate professional cover images for WeChat official account articles with multi-provider support (OpenAI DALL-E or Gemini).

What Makes a Good WeChat Cover?

Aspect ratio: 2.35:1 (wide cinematic format)
Time-prefixed filename: Use YYYY-MM-DD-wechat-cover-title.png format.
No text: WeChat overlays the article title
Visual focus: One clear focal point, not cluttered
Clean & bright: Modern aesthetic suitable for WeChat subscription feeds

Usage

Basic generation (OpenAI by default):

uv run skills/wechat-cover/scripts/generate.py \
  --title "Your Article Title" \
  --topic "AI tools"

With Gemini provider:

uv run skills/wechat-cover/scripts/generate.py \
  --title "Your Article Title" \
  --topic "AI tools" \
  --provider gemini

With custom base URL (OpenAI-compatible proxy):

export OPENAI_BASE_URL="https://your-proxy.com/v1"
export OPENAI_API_KEY="sk-..."

uv run skills/wechat-cover/scripts/generate.py \
  --title "Your Article Title" \
  --topic "AI tools" \
  --provider openai

Parameters

Parameter	Required	Description
`--title`	Yes	Article title (used to understand context)
`--topic`	Yes	Topic/category (e.g., "technology", "AI")
`--provider`	No	`openai` (default) or `gemini`
`--base-url`	No	OpenAI-compatible base URL (env: OPENAI_BASE_URL)
`--model`	No	Model name override
`--style`	No	Style variant: default, tech, business, lifestyle, creative
`--filename`	No	Output filename (auto-generated if omitted)
`--resolution`	No	1K/2K/4K (default: 2K)
`--output-dir`	No	Output directory (default: current directory)
`--api-key`	No	API key (settings.json > env var)

Configuration File (settings.json)

{
  "openai": {
    "api_key": "sk-...",
    "base_url": "https://your-proxy.com/v1",
    "model": "dall-e-3"
  },
  "gemini": {
    "api_key": "your-gemini-key",
    "model": "gemini-3-pro-image-preview"
  },
  "default_provider": "openai",
  "default_resolution": "2K",
  "default_style": "default"
}

OpenAI-compatible proxies (e.g. palebluedot, new-api) that use /v1/chat/completions for image generation are auto-detected and supported. Set base_url and model accordingly.

Priority order: CLI argument > settings.json > environment variable

Style Variants

All styles follow Anthropic's Claude design language — clean, bright, and restrained:

Variant	Description
`default`	Warm minimalist: cream, beige, coral, sage. Organic shapes, soft lighting, generous whitespace
`tech`	Cool modern: off-white, slate blue, lavender, cyan. Geometric lines, glass morphism, grid composition
`business`	Professional: warm white, navy, charcoal, amber. Architectural lines, natural light, clear hierarchy
`lifestyle`	Warm organic: cream, blush, sage, golden. Natural textures, golden-hour light, handcrafted feel
`creative`	Refined bold: white, coral red, teal, gold. Abstract geometric, asymmetric, paper-cut aesthetic

Environment Variables

Variable	Provider	Description
`OPENAI_API_KEY`	openai	OpenAI API key
`OPENAI_BASE_URL`	openai	OpenAI-compatible proxy URL (optional)
`GEMINI_API_KEY`	gemini	Gemini API key

Resolution Guide

Resolution	Dimensions (OpenAI)	Dimensions (Gemini)	Use Case
`1K`	1024×1024	1024×1024	Preview/thumbnail
`2K`	1792×1024	2048×2048	Standard cover
`4K`	1792×1024	4096×4096	High quality

Examples

Tech article with OpenAI:

uv run skills/wechat-cover/scripts/generate.py \
  --title "2024年最值得学习的编程语言" \
  --topic "technology" \
  --style tech \
  --resolution 2K

Business article with Gemini:

uv run skills/wechat-cover/scripts/generate.py \
  --title "职场沟通技巧" \
  --topic "business" \
  --style business \
  --provider gemini

Lifestyle article:

uv run skills/wechat-cover/scripts/generate.py \
  --title "周末去哪儿：杭州小众咖啡馆推荐" \
  --topic "lifestyle" \
  --style lifestyle \
  --output-dir ./covers

Output

Auto-cropped and resized to 900×383 (2.35:1 WeChat cover format)
Saves to specified directory (default: current directory)
Filename format: YYYY-MM-DD-wechat-cover-{title-slug}.png
Format: PNG for best quality

Requirements

uv installed for Python script execution
Pillow (pip install Pillow) for image cropping/resizing
For OpenAI provider: OpenAI API key from OpenAI Platform
For Gemini provider: Gemini API key from Google AI Studio

WeChat Cover

安装技能