Image Generation

from django_cfg.modules.django_llm.features.image_gen import ImageGenClient
 
client = ImageGenClient()
 
response = client.generate(
    prompt="A sunset over mountains, photorealistic",
    model_quality="best",
    size="1024x1024"
)
print(response.first_url)
print(f"Cost: ${response.cost_usd:.4f}")

client = ImageGenClient(
    api_key="sk-or-v1-...",  # Optional, auto-detected
)

response = client.generate(
    prompt="A futuristic city at night",
    model_quality="balanced",
    size="1024x1024",
    quality="hd",       # standard or hd
    style="vivid"       # vivid or natural
)
 
# Access results
print(response.first_url)      # First image URL
print(response.count)          # Number of images
print(f"Cost: ${response.cost_usd:.4f}")

# Returns URL directly
url = client.generate_quick("A cute cat wearing a hat")

response = client.generate(
    prompt="Abstract art",
    n=4,  # Generate 4 images
    size="1024x1024"
)
 
for img in response.images:
    print(img.url)

# Fast - cheapest
response = client.generate(
    prompt="...",
    model_quality="fast"
)
 
# Balanced - good quality/cost ratio
response = client.generate(
    prompt="...",
    model_quality="balanced"
)
 
# Best - highest quality
response = client.generate(
    prompt="...",
    model_quality="best"
)

# Landscape
response = client.generate(
    prompt="Mountain panorama",
    size="1792x1024"
)
 
# Portrait
response = client.generate(
    prompt="Standing figure",
    size="1024x1792"
)

response = client.generate(
    prompt="Product photo",
    quality="hd",
    style="natural"
)

response = await client.agenerate(
    prompt="Abstract art",
    size="1024x1024"
)

from django_cfg.modules.django_llm.features.image_gen import (
    ImageGenResponse,
    GeneratedImage,
)
 
# ImageGenResponse properties
response.first_url      # First image URL
response.images         # List[GeneratedImage]
response.count          # Number of images
response.cost_usd       # Total cost
response.model          # Model used
response.prompt         # Original prompt
 
# GeneratedImage properties
img = response.images[0]
img.url                 # Image URL
img.b64_json           # Base64 data (if requested)
img.revised_prompt     # Model's revised prompt

from django_cfg.modules.django_llm.features.image_gen import ImageGenRequest
 
request = ImageGenRequest(
    prompt="A sunset",
    n=2,
    size="1024x1024",
    quality="hd",
    style="vivid"
)

response = client.generate(prompt="...")
print(f"Cost: ${response.cost_usd:.4f}")

# Be specific
response = client.generate(
    prompt="A red sports car on a coastal road at sunset, "
           "dramatic lighting, photorealistic, 4K quality"
)
 
# Include style hints
response = client.generate(
    prompt="Portrait in the style of Renaissance painting, "
           "soft lighting, oil on canvas texture"
)

try:
    response = client.generate(prompt="...")
except Exception as e:
    print(f"Generation failed: {e}")