🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Baoyu Image Gen
πŸ¦€ ClawHub

Baoyu Image Gen

by @jimliu

AI image generation with OpenAI GPT Image 2, Azure OpenAI, Google, OpenRouter, DashScope, Z.AI GLM-Image, MiniMax, Jimeng, Seedream and Replicate APIs. Suppo...

Versionv2.0.0
Downloads3,864
Installs84
Stars⭐ 1
#crypto-defi#devops#image-gen#legal
TERMINAL
clawhub install baoyu-image-gen

πŸ“– About This Skill

name: baoyu-image-gen description: AI image generation with OpenAI, Google, DashScope and Replicate APIs. Supports text-to-image, reference images, aspect ratios. Sequential by default; parallel generation available on request. Use when user asks to generate, create, or draw images.

Image Generation (AI SDK)

Official API-based image generation. Supports OpenAI, Google, DashScope (ι˜Ώι‡Œι€šδΉ‰δΈ‡θ±‘) and Replicate providers.

Script Directory

Agent Execution: 1. SKILL_DIR = this SKILL.md file's directory 2. Script path = ${SKILL_DIR}/scripts/main.ts

Step 0: Load Preferences β›” BLOCKING

CRITICAL: This step MUST complete BEFORE any image generation. Do NOT skip or defer.

Check EXTEND.md existence (priority: project β†’ user):

test -f .baoyu-skills/baoyu-image-gen/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md" && echo "user"

| Result | Action | |--------|--------| | Found | Load, parse, apply settings. If default_model.[provider] is null β†’ ask model only (Flow 2) | | Not found | β›” Run first-time setup (references/config/first-time-setup.md) β†’ Save EXTEND.md β†’ Then continue |

CRITICAL: If not found, complete the full setup (provider + model + quality + save location) using AskUserQuestion BEFORE generating any images. Generation is BLOCKED until EXTEND.md is created.

| Path | Location | |------|----------| | .baoyu-skills/baoyu-image-gen/EXTEND.md | Project directory | | $HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md | User home |

EXTEND.md Supports: Default provider | Default quality | Default aspect ratio | Default image size | Default models

Schema: references/config/preferences-schema.md

Usage

# Basic
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png
With aspect ratio

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9
High quality

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k
From prompt files

npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png
With reference images (Google multimodal or OpenAI edits)

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png
With reference images (explicit provider/model)

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png
Specific provider

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
DashScope (ι˜Ώι‡Œι€šδΉ‰δΈ‡θ±‘)

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "δΈ€εͺε―ηˆ±ηš„ηŒ«" --image out.png --provider dashscope
Replicate (google/nano-banana-pro)

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
Replicate with specific model

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana

Options

| Option | Description | |--------|-------------| | --prompt , -p | Prompt text | | --promptfiles | Read prompt from files (concatenated) | | --image | Output image path (required) | | --provider google\|openai\|dashscope\|replicate | Force provider (default: google) | | --model , -m | Model ID (Google: gemini-3-pro-image-preview, gemini-3.1-flash-image-preview; OpenAI: gpt-image-1.5) | | --ar | Aspect ratio (e.g., 16:9, 1:1, 4:3) | | --size | Size (e.g., 1024x1024) | | --quality normal\|2k | Quality preset (default: 2k) | | --imageSize 1K\|2K\|4K | Image size for Google (default: from quality) | | --ref | Reference images. Supported by Google multimodal (gemini-3-pro-image-preview, gemini-3-flash-preview, gemini-3.1-flash-image-preview) and OpenAI edits (GPT Image models). If provider omitted: Google first, then OpenAI | | --n | Number of images | | --json | JSON output |

Environment Variables

| Variable | Description | |----------|-------------| | OPENAI_API_KEY | OpenAI API key | | GOOGLE_API_KEY | Google API key | | DASHSCOPE_API_KEY | DashScope API key (ι˜Ώι‡ŒδΊ‘) | | REPLICATE_API_TOKEN | Replicate API token | | OPENAI_IMAGE_MODEL | OpenAI model override | | GOOGLE_IMAGE_MODEL | Google model override | | DASHSCOPE_IMAGE_MODEL | DashScope model override (default: z-image-turbo) | | REPLICATE_IMAGE_MODEL | Replicate model override (default: google/nano-banana-pro) | | OPENAI_BASE_URL | Custom OpenAI endpoint | | GOOGLE_BASE_URL | Custom Google endpoint | | DASHSCOPE_BASE_URL | Custom DashScope endpoint | | REPLICATE_BASE_URL | Custom Replicate endpoint |

Load Priority: CLI args > EXTEND.md > env vars > /.baoyu-skills/.env > ~/.baoyu-skills/.env

Replicate Model Configuration

When using --provider replicate, the model can be configured in the following ways (highest priority first):

1. CLI flag: --model 2. EXTEND.md: default_model.replicate 3. Env var: REPLICATE_IMAGE_MODEL 4. Built-in default: google/nano-banana-pro

Supported model formats:

  • owner/name (recommended for official models), e.g. google/nano-banana-pro
  • owner/name:version (community models by version), e.g. stability-ai/sdxl:

    • Examples:

    # Use Replicate default model
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
    Override model explicitly
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana

    Provider Selection

    1. --ref provided + no --provider β†’ auto-select Google first, then OpenAI, then Replicate 2. --provider specified β†’ use it (if --ref, must be google, openai, or replicate) 3. Only one API key available β†’ use that provider 4. Multiple available β†’ default to Google

    Quality Presets

    | Preset | Google imageSize | OpenAI Size | Use Case | |--------|------------------|-------------|----------| | normal | 1K | 1024px | Quick previews | | 2k (default) | 2K | 2048px | Covers, illustrations, infographics |

    Google imageSize: Can be overridden with --imageSize 1K|2K|4K

    Aspect Ratios

    Supported: 1:1, 16:9, 9:16, 4:3, 3:4, 2.35:1

  • Google multimodal: uses imageConfig.aspectRatio
  • Google Imagen: uses aspectRatio parameter
  • OpenAI: maps to closest supported size

    • Generation Mode

    Default: Sequential generation (one image at a time). This ensures stable output and easier debugging.

    Parallel Generation: Only use when user explicitly requests parallel/concurrent generation.

    | Mode | When to Use | |------|-------------| | Sequential (default) | Normal usage, single images, small batches | | Parallel | User explicitly requests, large batches (10+) |

    Parallel Settings (when requested):

    | Setting | Value | |---------|-------| | Recommended concurrency | 4 subagents | | Max concurrency | 8 subagents | | Use case | Large batch generation when user requests parallel |

    Agent Implementation (parallel mode only): 

    # Launch multiple generations in parallel using Task tool

    Each Task runs as background subagent with run_in_background=true
    

    Collect results via TaskOutput when all complete

    Error Handling

  • Missing API key β†’ error with setup instructions
  • Generation failure β†’ auto-retry once
  • Invalid aspect ratio β†’ warning, proceed with default
  • Reference images with unsupported provider/model β†’ error with fix hint (switch to Google multimodal: gemini-3-pro-image-preview, gemini-3.1-flash-image-preview; or OpenAI GPT Image edits)

    • Extension Support

    Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

    πŸ’‘ Examples

    # Basic
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png
    With aspect ratio
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9
    High quality
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k
    From prompt files
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png
    With reference images (Google multimodal or OpenAI edits)
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png
    With reference images (explicit provider/model)
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png
    Specific provider
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
    DashScope (ι˜Ώι‡Œι€šδΉ‰δΈ‡θ±‘)
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "δΈ€εͺε―ηˆ±ηš„ηŒ«" --image out.png --provider dashscope
    Replicate (google/nano-banana-pro)
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
    Replicate with specific model
    
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana

    βš™οΈ Configuration

    | Option | Description | |--------|-------------| | --prompt , -p | Prompt text | | --promptfiles | Read prompt from files (concatenated) | | --image | Output image path (required) | | --provider google\|openai\|dashscope\|replicate | Force provider (default: google) | | --model , -m | Model ID (Google: gemini-3-pro-image-preview, gemini-3.1-flash-image-preview; OpenAI: gpt-image-1.5) | | --ar | Aspect ratio (e.g., 16:9, 1:1, 4:3) | | --size | Size (e.g., 1024x1024) | | --quality normal\|2k | Quality preset (default: 2k) | | --imageSize 1K\|2K\|4K | Image size for Google (default: from quality) | | --ref | Reference images. Supported by Google multimodal (gemini-3-pro-image-preview, gemini-3-flash-preview, gemini-3.1-flash-image-preview) and OpenAI edits (GPT Image models). If provider omitted: Google first, then OpenAI | | --n | Number of images | | --json | JSON output |