/ads generate — AI Ad Image Generator

> Generates platform-sized ad creative images from your campaign brief and brand > profile. Uses Gemini by default.

Usage

bash
/ads generate
/ads generate --platform meta
/ads generate --prompt "text" --ratio 9:16
/ads generate --batch

Arguments

| Flag | Type | Default | Description | |------|------|---------|-------------| | --platform | string | all | Generate for specific platform only | | --prompt | string | — | Standalone generation without brief | | --ratio | string | — | Aspect ratio for standalone mode | | --batch | flag | false | Use batch API (50% cost, 24h turnaround) |

Environment Setup

bash
# Gemini (default)
export GOOGLE_API_KEY="your-key"

# Alternative providers
export ADS_IMAGE_PROVIDER="openai"
export OPENAI_API_KEY="your-key"

export ADS_IMAGE_PROVIDER="stability"
export STABILITY_API_KEY="your-key"

export ADS_IMAGE_PROVIDER="replicate"
export REPLICATE_API_TOKEN="your-token"

Process

Step 1: Check API Key

Verify the required environment variable is set before proceeding. If not set, display setup instructions and stop.

Step 2: Locate Source Files

Check for:

• campaign-brief.md — primary source for prompts and dimensions
• brand-profile.json — brand color/style injection (optional but recommended)

If no campaign-brief.md: enter standalone mode (ask for prompt, platform, filename).

Step 3: Parse Image Generation Briefs

From ## Image Generation Briefs section of campaign-brief.md, extract each brief's prompt, dimensions, and safe zone notes.

Step 4: Generate Images

For each brief, call the image generation API with:

• Constructed prompt (brief prompt + brand DNA injection)
• Platform-correct dimensions
• Output path: ./ad-assets/[platform]/[concept]/[filename].png

Step 5: Validate Formats

Check all generated images against platform spec requirements (dimensions, file size).

Step 6: Report Results

Generation complete:

  Generated assets:
    ./ad-assets/meta/concept-1/feed-1080x1350.png
    ./ad-assets/tiktok/concept-1/vertical-1080x1920.png

  Cost estimate: ~$[N] at $0.067/image (Gemini)

  Next steps:
    1. Review assets in ./ad-assets/
    2. Upload to your ad platform managers

Platform Dimensions (Standalone Mode)

meta-feed     -> 1080x1350 (4:5)
meta-reels    -> 1080x1920 (9:16)
tiktok        -> 1080x1920 (9:16)
google-pmax   -> 1200x628 (1.91:1)
linkedin      -> 1080x1080 (1:1)
youtube       -> 1280x720 (16:9)
youtube-short -> 1080x1920 (9:16)

Cost Transparency

Before generating, estimate and show the cost:

• Count image briefs x $0.067 (Gemini default)
• If >$1.00, ask for confirmation before proceeding

Dependencies

• brand-profile.json — from /ads dna
• campaign-brief.md — from /ads create
• Image generation API key (see Environment Setup)