1---
2name: preferences-schema
3description: EXTEND.md YAML schema for baoyu-image-gen user preferences
4---
5 
6# Preferences Schema
7 
8## Full Schema
9 
10```yaml
11---
12version: 1
13 
14default_provider: null      # google|openai|azure|openrouter|dashscope|minimax|replicate|zai|null (null = auto-detect)
15 
16default_quality: null       # normal|2k|null (null = use default: 2k)
17 
18default_aspect_ratio: null  # "16:9"|"1:1"|"4:3"|"3:4"|"2.35:1"|null
19 
20default_image_size: null    # 1K|2K|4K|null (Google/OpenRouter, overrides quality)
21 
22default_model:
23  google: null              # e.g., "gemini-3-pro-image-preview", "gemini-3.1-flash-image-preview"
24  openai: null              # e.g., "gpt-image-1.5", "gpt-image-1"
25  azure: null               # Azure deployment name, e.g., "gpt-image-1.5" or "image-prod"
26  openrouter: null          # e.g., "google/gemini-3.1-flash-image-preview"
27  dashscope: null           # e.g., "qwen-image-2.0-pro"
28  minimax: null             # e.g., "image-01"
29  replicate: null           # e.g., "google/nano-banana-pro"
30  zai: null                 # e.g., "glm-image", "cogview-4-250304"
31 
32batch:
33  max_workers: 10
34  provider_limits:
35    replicate:
36      concurrency: 5
37      start_interval_ms: 700
38    google:
39      concurrency: 3
40      start_interval_ms: 1100
41    openai:
42      concurrency: 3
43      start_interval_ms: 1100
44    azure:
45      concurrency: 3
46      start_interval_ms: 1100
47    openrouter:
48      concurrency: 3
49      start_interval_ms: 1100
50    dashscope:
51      concurrency: 3
52      start_interval_ms: 1100
53    minimax:
54      concurrency: 3
55      start_interval_ms: 1100
56    zai:
57      concurrency: 3
58      start_interval_ms: 1100
59---
60```
61 
62## Field Reference
63 
64| Field | Type | Default | Description |
65|-------|------|---------|-------------|
66| `version` | int | 1 | Schema version |
67| `default_provider` | string\|null | null | Default provider (null = auto-detect) |
68| `default_quality` | string\|null | null | Default quality (null = 2k) |
69| `default_aspect_ratio` | string\|null | null | Default aspect ratio |
70| `default_image_size` | string\|null | null | Google/OpenRouter image size (overrides quality) |
71| `default_model.google` | string\|null | null | Google default model |
72| `default_model.openai` | string\|null | null | OpenAI default model |
73| `default_model.azure` | string\|null | null | Azure default deployment name |
74| `default_model.openrouter` | string\|null | null | OpenRouter default model |
75| `default_model.dashscope` | string\|null | null | DashScope default model |
76| `default_model.minimax` | string\|null | null | MiniMax default model |
77| `default_model.replicate` | string\|null | null | Replicate default model |
78| `default_model.zai` | string\|null | null | Z.AI default model (glm-image / cogview-4-*) |
79| `batch.max_workers` | int\|null | 10 | Batch worker cap |
80| `batch.provider_limits.<provider>.concurrency` | int\|null | provider default | Max simultaneous requests per provider |
81| `batch.provider_limits.<provider>.start_interval_ms` | int\|null | provider default | Minimum gap between request starts per provider |
82 
83## Examples
84 
85**Minimal**:
86```yaml
87---
88version: 1
89default_provider: google
90default_quality: 2k
91---
92```
93 
94**Full**:
95```yaml
96---
97version: 1
98default_provider: google
99default_quality: 2k
100default_aspect_ratio: "16:9"
101default_image_size: 2K
102default_model:
103  google: "gemini-3-pro-image-preview"
104  openai: "gpt-image-1.5"
105  azure: "gpt-image-1.5"
106  openrouter: "google/gemini-3.1-flash-image-preview"
107  dashscope: "qwen-image-2.0-pro"
108  minimax: "image-01"
109  replicate: "google/nano-banana-pro"
110  zai: "glm-image"
111batch:
112  max_workers: 10
113  provider_limits:
114    replicate:
115      concurrency: 5
116      start_interval_ms: 700
117    azure:
118      concurrency: 3
119      start_interval_ms: 1100
120    openrouter:
121      concurrency: 3
122      start_interval_ms: 1100
123    minimax:
124      concurrency: 3
125      start_interval_ms: 1100
126    zai:
127      concurrency: 3
128      start_interval_ms: 1100
129---
130```
131