Baoyu Imagine

MiniMax Models

Use --model image-01 or set default_model.minimax / MINIMAX_IMAGE_MODEL when the user wants MiniMax image generation.

Official MiniMax image model options currently documented in the API reference:

• image-01 (recommended default)
  • Supports text-to-image and subject-reference image generation
  • Supports official aspect_ratio values: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
  • Supports documented custom width / height output sizes when using --size <WxH>
  • width and height must both be between 512 and 2048, and both must be divisible by 8
• image-01-live
  • Lower-latency variant
  • Use --ar for sizing; MiniMax documents custom width / height as only effective for image-01

MiniMax subject reference notes:

• --ref files are sent as MiniMax subject_reference
• MiniMax docs currently describe subject_reference[].type as character
• Official docs say image_file supports public URLs or Base64 Data URLs; baoyu-imagine sends local refs as Data URLs
• Official docs recommend front-facing portrait references in JPG/JPEG/PNG under 10MB

Official references:

• MiniMax Image Generation Guide
• MiniMax Text-to-Image API
• MiniMax Image-to-Image API

OpenRouter Models

Use full OpenRouter model IDs, e.g.:

• google/gemini-3.1-flash-image-preview (recommended, supports image output and reference-image workflows)
• google/gemini-2.5-flash-image-preview
• black-forest-labs/flux.2-pro
• Other OpenRouter image-capable model IDs

Notes:

• OpenRouter image generation uses /chat/completions, not the OpenAI /images endpoints
• If --ref is used, choose a multimodal model that supports image input and image output
• --imageSize maps to OpenRouter imageGenerationOptions.size; --size <WxH> is converted to the nearest OpenRouter size and inferred aspect ratio when possible

Replicate Models

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
${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate

# Override model explicitly
${BUN_X} {baseDir}/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 Azure, then OpenRouter, then Replicate, then Seedream, then MiniMax (MiniMax subject reference is more specialized toward character/portrait consistency)
2. --provider specified → use it (if --ref, must be google, openai, azure, openrouter, replicate, seedream, or minimax)
3. Only one API key available → use that provider
4. Multiple available → default to Google

Quality Presets

Google/OpenRouter 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
• OpenAI: maps to closest supported size
• OpenRouter: sends imageGenerationOptions.aspect_ratio; if only --size <WxH> is given, aspect ratio is inferred automatically
• Replicate: passes aspect_ratio to model; when --ref is provided without --ar, defaults to match_input_image
• MiniMax: sends official aspect_ratio values directly; if --size <WxH> is given without --ar, width / height are sent for image-01

Generation Mode

Default: Sequential generation.

Batch Parallel Generation: When --batchfile contains 2 or more pending tasks, the script automatically enables parallel generation.

Execution choice:

Rule of thumb:

• Prefer batch over subagents once prompt files are already saved and the task is "generate all of these"
• Use subagents only when generation is coupled with per-image thinking, rewriting, or divergent creative exploration

Parallel behavior:

• Default worker count is automatic, capped by config, built-in default 10
• Provider-specific throttling is applied only in batch mode, and the built-in defaults are tuned for faster throughput while still avoiding obvious RPM bursts
• You can override worker count with --jobs <count>
• Each image retries automatically up to 3 attempts
• Final output includes success count, failure count, and per-image failure reasons

Error Handling

• Missing API key → error with setup instructions
• Generation failure → auto-retry up to 3 attempts per image
• Invalid aspect ratio → warning, proceed with default
• Reference images with unsupported provider/model → error with fix hint

Extension Support

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