Image Generation (AI SDK)
Official API-based image generation. Supports OpenAI, Google, DashScope (阿里通义万象) and Replicate providers.
Script Directory
Agent Execution:
SKILL_DIR
= this SKILL.md file's directory- 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 <text>
, -p
| Prompt text |
--promptfiles <files...>
| Read prompt from files (concatenated) |
--image <path>
| Output image path (required) |
--provider google|openai|dashscope|replicate
| Force provider (default: google) |
--model <id>
, -m
| Model ID (Google: gemini-3-pro-image-preview
, gemini-3.1-flash-image-preview
; OpenAI: gpt-image-1.5
) |
--ar <ratio>
| Aspect ratio (e.g., 16:9
, 1:1
, 4:3
) |
--size <WxH>
| Size (e.g., 1024x1024
) |
--quality normal|2k
| Quality preset (default: 2k) |
--imageSize 1K|2K|4K
| Image size for Google (default: from quality) |
--ref <files...>
| 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 <count>
| 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 >
<cwd>/.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):
- CLI flag:
--model <owner/name>
- EXTEND.md:
default_model.replicate
- Env var:
REPLICATE_IMAGE_MODEL
- 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
--ref
provided + no --provider
→ auto-select Google first, then OpenAI, then Replicate--provider
specified → use it (if --ref
, must be google
, openai
, or replicate
)- Only one API key available → use that provider
- 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.
