Image Generation (AI SDK)

Official API-based image generation. Supports OpenAI, Google, DashScope (阿里通义万象) and Replicate providers.

Script Directory

Agent Execution:

1. 1. SKILL_DIR = this SKILL.md file's directory
2. Script path = INLINECODE1

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

CODEBLOCK0

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
INLINECODE3	Project directory
INLINECODE4

User home |

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

Schema: INLINECODE5

Usage

CODEBLOCK1

Options

Option	Description
INLINECODE6, INLINECODE7	Prompt text
INLINECODE8

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
INLINECODE30	OpenAI API key
INLINECODE31

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 > INLINECODE43

Replicate Model Configuration

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

1. 1. CLI flag: INLINECODE45
2. EXTEND.md: INLINECODE46
3. Env var: INLINECODE47
4. Built-in default: INLINECODE48

Supported model formats:

• - owner/name (recommended for official models), e.g. INLINECODE50
• INLINECODE51 (community models by version), e.g. INLINECODE52

Examples:

CODEBLOCK2

Provider Selection

1. 1. --ref provided + no --provider → auto-select Google first, then OpenAI, then Replicate
2. INLINECODE55 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
INLINECODE60	1K	1024px	Quick previews
INLINECODE61 (default)

2K | 2048px | Covers, illustrations, infographics |

Google imageSize: Can be overridden with INLINECODE62

Aspect Ratios

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

• - Google multimodal: uses INLINECODE69
• 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):
CODEBLOCK3

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.