v0.4.1: Explicit Model Selection for Image Generation
🔧 Breaking Changes
This release corrects the image generation API to require explicit model selection. No automatic fallback or model selection.
Migration Required
# Old (v0.4.0)
provider = GPT4oImageProvider(api_key="...")
response = provider.generate(prompt="...")
# New (v0.4.1)
provider = OpenAIImageProvider(api_key="...")
response = provider.generate(
model=ImageModel.DALLE_3, # REQUIRED
prompt="..."
)✨ What's New
- Explicit Model Selection: Every request must specify which model to use
- Three Models Available:
dall-e-2: Multiple images, editing, 256x256 to 1024x1024dall-e-3: Styles, HD quality, up to 1792x1024, revised promptsgpt-image-1: Token pricing, 4K resolution (4096x4096), better instruction following
- Model-Specific Validation: Each model validates its specific parameters
- Token Usage Tracking: GPT-Image-1 returns token usage information
📦 Installation
pip install ai-proxy-core==0.4.1🚀 Quick Start
from ai_proxy_core import OpenAIImageProvider, ImageModel
provider = OpenAIImageProvider(api_key="your-key")
# Must specify model explicitly
response = provider.generate(
model=ImageModel.DALLE_3,
prompt="Modern app icon",
size="1024x1024",
quality="hd"
)🔍 Available Models
| Model | Max Size | Features | Special |
|---|---|---|---|
| dall-e-2 | 1024x1024 | Edit, Multiple images (n≤10) | Lowest cost |
| dall-e-3 | 1792x1024 | Styles, HD quality | Best for art |
| gpt-image-1 | 4096x4096 | Token pricing, Better instructions | Best quality |
🐛 Fixes
- Fixed GPT-Image-1 response_format parameter handling
- Corrected model-specific size validation
- Improved error messages for invalid models
Full Changelog: v0.4.0...v0.4.1