1# Usage Examples
2 
3Extended CLI examples. SKILL.md shows the minimum set; read this file when the user asks about provider-specific invocation, batch generation, or less-common flags.
4 
5## Core Patterns
6 
7```bash
8# Basic text-to-image
9${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image cat.png
10 
11# With aspect ratio
12${BUN_X} {baseDir}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9
13 
14# High quality
15${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k
16 
17# Prompt from files
18${BUN_X} {baseDir}/scripts/main.ts --promptfiles system.md content.md --image out.png
19 
20# With reference images (any provider family that supports refs)
21${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png
22```
23 
24## Per-Provider
25 
26```bash
27# OpenAI
28${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
29 
30# Azure OpenAI (model = deployment name)
31${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider azure --model gpt-image-1.5
32 
33# Google with explicit model
34${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png
35 
36# OpenRouter (recommended default)
37${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider openrouter
38 
39# OpenRouter with reference
40${BUN_X} {baseDir}/scripts/main.ts --prompt "Make blue" --image out.png --provider openrouter --model google/gemini-3.1-flash-image-preview --ref source.png
41 
42# DashScope (default model)
43${BUN_X} {baseDir}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope
44 
45# DashScope Qwen-Image 2.0 Pro (custom size, Chinese text)
46${BUN_X} {baseDir}/scripts/main.ts --prompt "为咖啡品牌设计一张 21:9 横幅海报，包含清晰中文标题" --image out.png --provider dashscope --model qwen-image-2.0-pro --size 2048x872
47 
48# DashScope legacy fixed-size
49${BUN_X} {baseDir}/scripts/main.ts --prompt "一张电影感海报" --image out.png --provider dashscope --model qwen-image-max --size 1664x928
50 
51# Z.AI GLM-image
52${BUN_X} {baseDir}/scripts/main.ts --prompt "一张带清晰中文标题的科技海报" --image out.png --provider zai
53 
54# Z.AI with custom size
55${BUN_X} {baseDir}/scripts/main.ts --prompt "A science illustration with labels" --image out.png --provider zai --model glm-image --size 1472x1088
56 
57# MiniMax
58${BUN_X} {baseDir}/scripts/main.ts --prompt "A fashion editorial portrait" --image out.jpg --provider minimax
59 
60# MiniMax with subject reference (character/portrait consistency)
61${BUN_X} {baseDir}/scripts/main.ts --prompt "A girl by the library window" --image out.jpg --provider minimax --model image-01 --ref portrait.png --ar 16:9
62 
63# Replicate (default: google/nano-banana-2)
64${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
65 
66# Replicate Seedream 4.5
67${BUN_X} {baseDir}/scripts/main.ts --prompt "A cinematic portrait" --image out.png --provider replicate --model bytedance/seedream-4.5 --ar 3:2
68 
69# Replicate Wan 2.7 Image Pro
70${BUN_X} {baseDir}/scripts/main.ts --prompt "A concept frame" --image out.png --provider replicate --model wan-video/wan-2.7-image-pro --size 2048x1152
71```
72 
73## Batch Mode
74 
75```bash
76# Batch from saved prompt files
77${BUN_X} {baseDir}/scripts/main.ts --batchfile batch.json
78 
79# Batch with explicit worker count
80${BUN_X} {baseDir}/scripts/main.ts --batchfile batch.json --jobs 4 --json
81```
82 
83### Batch File Format
84 
85```json
86{
87  "jobs": 4,
88  "tasks": [
89    {
90      "id": "hero",
91      "promptFiles": ["prompts/hero.md"],
92      "image": "out/hero.png",
93      "provider": "replicate",
94      "model": "google/nano-banana-2",
95      "ar": "16:9",
96      "quality": "2k"
97    },
98    {
99      "id": "diagram",
100      "promptFiles": ["prompts/diagram.md"],
101      "image": "out/diagram.png",
102      "ref": ["references/original.png"]
103    }
104  ]
105}
106```
107 
108Paths in `promptFiles`, `image`, and `ref` are resolved relative to the batch file's directory. `jobs` is optional (overridden by CLI `--jobs`). A top-level array without the `jobs` wrapper is also accepted.
109