2026.4.1

Multi-provider upgrade release

All three providers gain new default models and API parameters.

Gemini

• Default model: gemini-3-pro-image-preview ("Nano Banana Pro", premium quality, 10 aspect ratios, up to 14 reference images)
• Alternate: gemini-3.1-flash-image-preview ("Nano Banana 2", adds 4 extreme ratios 1:4/4:1/1:8/8:1 and 512 resolution)
• New flags:
  • --image-size — 512/1K/2K/4K (UPPERCASE required — hard API rejection on lowercase)
  • --thinking-level — minimal or High
  • --image-only — suppresses text response
  • --search-grounding — enables Google Search grounding

OpenAI

• Default model unchanged: gpt-image-1.5
• Alternate: gpt-image-1-mini (3-4x cheaper, use via --model)
• New flags:
  • --output-format — png/jpeg/webp (jpeg is faster than png)
  • --output-compression — 0-100 integer for jpeg/webp
  • --moderation — auto or low
  • --input-fidelity — low or high (edit mode, preserves faces/logos)
• --size, --quality, --background now accept auto

xAI

• Default model: grok-imagine-image-pro (premium tier, 30 RPM)
• Alternate: grok-imagine-image (standard, 300 RPM — use for bulk)
• New flag: --resolution — 1k or 2k (LOWERCASE required — opposite of Gemini!)
• New aspect ratios: 19.5:9, 9:19.5, 20:9, 9:20, auto
• Removed: grok-2-image references (deprecated 2026-02-28)

Documentation fixes

• Corrected Gemini 3.1 Flash pricing: 2K is $0.101 (not $0.134), 4K is $0.151 (not $0.268)
• Noted gemini-2.5-flash-image scheduled shutdown on 2026-10-02
• Clarified free tier status: unavailable on Gemini image gen (Dec 2025), removed from xAI (Mar 2026), OpenAI unchanged
• Documented xAI single-image-edit aspect ratio quirk (output matches input, cannot override)
• Updated OpenAI rate limits to IPM/TPM format
• Added JSON body alternative for /v1/images/edits documentation

Tests

• All 99 bats tests pass
• Updated default model assertions for gemini and xai

Full changelog: 2026.4.0...2026.4.1