1# Replicate
2 
3Read when the user picks `--provider replicate`. Replicate support is intentionally scoped to model families baoyu-imagine can validate locally and save without dropping outputs.
4 
5## Supported Families
6 
7**`google/nano-banana*`** (default: `google/nano-banana-2`)
8 
9- Supports prompt-only and reference-image generation
10- Uses Replicate `aspect_ratio`, `resolution`, and `output_format`
11- `--size <WxH>` is accepted only as a shorthand for a documented `aspect_ratio` plus `1K` / `2K`
12 
13**`bytedance/seedream-4.5`**
14 
15- Supports prompt-only and reference-image generation
16- Uses Replicate `size`, `aspect_ratio`, and `image_input`
17- Local validation blocks unsupported `1K` requests before the API call
18 
19**`bytedance/seedream-5-lite`**
20 
21- Supports prompt-only and reference-image generation
22- Uses Replicate `size`, `aspect_ratio`, and `image_input`
23- Local validation currently accepts `2K` / `3K` only
24 
25**`wan-video/wan-2.7-image`**
26 
27- Supports prompt-only and reference-image generation
28- Uses Replicate `size` and `images`
29- Max output is 2K
30 
31**`wan-video/wan-2.7-image-pro`**
32 
33- Supports prompt-only and reference-image generation
34- Uses Replicate `size` and `images`
35- 4K is allowed only for text-to-image; local validation blocks `4K + --ref`
36 
37## Guardrails
38 
39- Replicate currently supports only single-output save semantics in this tool — keep `--n 1`
40- If a model is outside the compatibility list above, baoyu-imagine treats it as prompt-only and rejects advanced local options instead of guessing a nano-banana-style schema
41 
42## Examples
43 
44```bash
45# Default model
46${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
47 
48# Explicit model
49${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana
50```
51