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

Preferences (EXTEND.md)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .baoyu-skills/baoyu-image-gen/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├──────────────────────────────────────────────────┼───────────────────┤ │ .baoyu-skills/baoyu-image-gen/EXTEND.md │ Project directory │ ├──────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md │ User home │ └──────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ Result │ Action │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Found │ Read, parse, apply settings │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Not found │ Use defaults │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

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

--prompt <text>

-p

--promptfiles <files...>

--image <path>

--provider google|openai|dashscope|replicate

--model <id>

-m

--ref

gpt-image-1.5

--ar <ratio>

16:9

1:1

4:3

--size <WxH>

1024x1024

--quality normal|2k

--imageSize 1K|2K|4K

--ref <files...>

--n <count>

--json

Environment Variables

OPENAI_API_KEY

GOOGLE_API_KEY

DASHSCOPE_API_KEY

REPLICATE_API_TOKEN

OPENAI_IMAGE_MODEL

GOOGLE_IMAGE_MODEL

DASHSCOPE_IMAGE_MODEL

REPLICATE_IMAGE_MODEL

OPENAI_BASE_URL

GOOGLE_BASE_URL

DASHSCOPE_BASE_URL

REPLICATE_BASE_URL

Load Priority: CLI args > EXTEND.md > env vars >

<cwd>/.baoyu-skills/.env

~/.baoyu-skills/.env

Replicate Model Configuration

When using

--provider replicate

1. CLI flag:

   --model <owner/name>

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:<version>

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

normal

2k

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.

Parallel Settings (when requested):

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 or OpenAI GPT Image edits)

Extension Support

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