================================================================
AI PRODUCT IMAGE GENERATOR — for OpenCart 3.x
================================================================

Generate professional product photos directly from the product
edit page. No Photoshop. No studio. No re-uploading.

⚡ Lifestyle shots in seconds — drop the product into any
interior or scene with a single click.

⚡ Batch-process all product photos at once — refresh your
entire catalog without lifting a finger.

⚡ Per-product memory — every setting saved automatically.
Open the same product a month later, your last setup loads.


================================================================
WHAT IT SOLVES
================================================================

Stop wasting time and money on:
✗ Hiring photographers for new SKUs
✗ Re-shooting products for seasonal campaigns
✗ Manually editing backgrounds in Photoshop
✗ Inconsistent product images across your catalog
✗ Hours wasted in image editor for every product

Instead:
✓ One floating button on the product edit page
✓ 30 seconds from idea to applied image
✓ AI handles backgrounds, lighting, composition
✓ Replace main photo or add as additional — instantly


================================================================
HOW IT WORKS (3 steps)
================================================================

1. Open any product → click the floating AI button
2. Describe the scene OR upload an interior reference photo
3. Hit Generate → Apply → Save product

That's it. Done.


================================================================
KEY FEATURES
================================================================

▶ TWO GENERATION MODES
• Create New — generate from a text prompt
• Edit Existing — re-imagine your existing photos in new
settings, lighting, or style

▶ BATCH PROCESSING
Select multiple photos of the same product, regenerate them
all in one go. Side-by-side Before/After preview. Apply
individually or all at once.

▶ BACKGROUND / INTERIOR UPLOAD
Upload your own interior photo — the product will be placed
into that exact scene, matching its lighting and perspective.

▶ PRODUCT DIMENSIONS (W × D × H cm)
Enter real-world size — the module converts it into scale
cues the AI can actually understand (human-scale references
like "knee-high", "tabletop-sized"). Dramatically improves
proportion consistency across multiple shots.

▶ 5 CAMERA SHOT PRESETS
• Hero — centered close shot for product cards
• Lifestyle — product in context with interior
• Close-up — texture and material detail
• Wide — full room context
• Flat lay — top-down composition
Plus an Auto preset that picks the right setup from
product dimensions.

▶ ADVANCED CAMERA CONTROLS
Fine-tune: focal length (24/35/50/85/105 mm), camera height
(eye-level / 3-4 above / low / top-down), distance, exact
frame-fill percentage. Override any preset.

▶ IN-SCENE PLACEMENT
When using a background photo, control: frame fill %,
product position (center / foreground / background / wall),
and facing angle (front / 3-4 / side / back).

▶ BUILT-IN CROP TOOL
Full crop tool with aspect-ratio presets (1:1, 4:3, 3:2,
16:9, free). Works on single results or one item in a batch.

▶ PER-PRODUCT MEMORY
All settings auto-saved per product on the server. Reopen
from any browser, your last setup loads automatically.

▶ GENERATION HISTORY
Every generated image stored per product. Searchable by
prompt. Re-apply old results, copy prompts back to input.

▶ MULTILINGUAL INTERFACE
Full localization: English, Russian, Ukrainian.
Interface, modal, JS messages and errors — all switch
with the OpenCart admin language.


================================================================
AI MODELS — YOU CHOOSE
================================================================

Pick the OpenAI model that fits your task and budget:

• gpt-image-2 — Latest, highest quality (default)
• gpt-image-2-2026-04-21 — Specific version pinning
• gpt-image-1.5 — Balanced
• gpt-image-1 — Solid baseline
• gpt-image-1-mini — Cheaper and faster (drafts)
• chatgpt-image-latest — Always-newest auto-pick

Plus quality levels (low / medium / high) and image sizes
(1024×1024 / 1024×1536 / 1536×1024).

Switch any time — no re-installation, no re-configuration.


================================================================
PERFECT FOR
================================================================

★ Decor, handmade, jewelry, fashion shops
Where lifestyle photos sell better than studio shots

★ Drop-shipping and white-label resellers
No physical access to products

★ Catalog refreshes
Seasonal campaigns, A/B testing visuals

★ New SKUs without photos yet
Generate placeholder visuals before the photoshoot

★ Multi-language stores
RU/UA/EN interface out of the box


================================================================
REQUIREMENTS
================================================================

• OpenCart 3.x
• PHP 7.1+
• PHP cURL and GD extensions
• Write permissions on /image/catalog/
• An OpenAI API key with billing enabled

⚠ IMPORTANT: AI generation costs are billed by OpenAI
directly to your account (typically $0.005 – $0.20 per
image depending on model and quality).
This module does NOT include API credits.

================================================================
WHAT'S INCLUDED
================================================================

✓ Full module (controller, views, JS, CSS)
✓ OCMOD installer (single XML file)
✓ Three full language packs: EN / RU / UK
✓ Email support
================================================================
HONEST NOTE ON QUALITY
================================================================

This module uses OpenAI's image-generation API.

These models produce excellent lifestyle and creative shots,
but like all current generative AIs they can introduce small
variations in product details across generations. The module
includes mechanisms to minimize this — dimensions, camera
presets, exact framing percentage, advanced prompt engineering.

For pixel-perfect product replication across multiple angles,
traditional photography remains the gold standard. This module
is the right choice for:
✓ Creative lifestyle and context shots
✓ Background changes and scene replacements
✓ Quick catalog visuals
✓ Iterating on composition before a real photoshoot


READY TO TRY?
================================================================

Install once, save hours every week.

Your product photos shouldn't be a bottleneck. They should
be a one-click feature.