Skip to content

v0.4.1: Explicit Model Selection for Image Generation

Choose a tag to compare

@ebowwa ebowwa released this 19 Aug 23:17

🔧 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 1024x1024
    • dall-e-3: Styles, HD quality, up to 1792x1024, revised prompts
    • gpt-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