mhinspeya/module-hyva-aiimages

Generates AI-based inspiration images in Magento 2 using style, scene, and gender parameters. The module stores generated images in a custom database table and provides a dedicated admin page with filtering options. Includes a daily usage dashboard with limits, partner key authentication, and token-

1.0.0 2025-11-28 07:18 UTC

Requires

• mhinspeya/backend-mod: ^1.0

Suggests

• mhinspeya/backend-mod: Support Configuration

OSL-3.0

• MHinspeya

• magento
• product images
• image generator
• magento2
• openai
• hyva
• stable diffusion
• MHinspeya
• AI images

README

mhinspeya/module-hyva-aiimages

• Main Functionalities
• Installation
• Configuration
• How It Works
• Generated Image Management
• Specifications
• Attributes

Main Functionalities

The MHinspeya Hyvä AI Inspiration Image Generator module allows Magento 2 merchants to generate AI-powered inspiration images for products based on:

• Style (e.g., Modern, Retro, Streetwear, Minimal)
• Scene (Studio, Outdoor, Lifestyle, Flat Lay)
• Gender (Male, Female, Unisex)

🧠 Important:
This module does not replace product images and does not save images into Magento’s media gallery.

Instead:

• AI-generated images are stored in a custom database table.
• Images are shown in a separate admin section.
• You get a dedicated page to browse all generated images with filters based on style, scene, and gender.

Installation

* For production environments, use: --keep-generated.

Type 1: Zip File Installation

1. Extract to:

   app/code/MHinspeya/Inspiration
   

2. Enable module:

   php bin/magento module:enable MHinspeya_Inspiration
   

3. Run upgrade:

   php bin/magento setup:upgrade
   

4. Flush cache:

   php bin/magento cache:flush
   

Type 2: Composer Installation

1. Add repository (if private):

   composer config repositories.inspeya composer https://repo.inspeya.com/
   

2. Install module:

   composer require mhinspeya/module-hyva-aiimages
   

3. Enable module:

   php bin/magento module:enable MHinspeya_Inspiration
   

4. Upgrade:

   php bin/magento setup:upgrade
   

5. Clear cache:

   php bin/magento cache:flush
   

Configuration

Admin path:

Stores → Configuration → MHinspeya → AI Inspiration Images

Available Settings:

• API Provider (OpenAI, Stable Diffusion, Custom model)
• API Key
• Default Style / Scene / Gender
• Generated image resolution
• Cleanup behavior (keep or auto-delete old generations)

How It Works

1. Admin visits product editing page.
2. Opens the AI Inspiration Image Generator section.
3. Selects:
   • Style
   • Scene
   • Gender
4. Clicks Generate Image.
5. The module calls the configured AI model API.
6. The generated image is:
   • Stored in a custom table
   • Displayed in the UI for preview
   • NOT added to Magento media gallery

Generated Image Management

The module adds a new admin page:

Marketing → AI Inspiration Images

This page shows:

• ✔ All AI-generated images
• ✔ Filters for:
  • Style
  • Scene
  • Gender
  • Product
  • Date
• ✔ Pagination
• ✔ Large image preview
• ✔ Internal ID, prompt details, and meta information

This lets you review and manage thousands of generated images without touching product media.

Specifications

Feature	Support
Hyvä Compatibility	✔
AI Image Generation (Style / Scene / Gender)	✔
Custom database storage	✔
Separate image listing page	✔
Filter & search functionality	✔
No media gallery save	✔
No product image replacement	✔
Multi-store Support	✔
API Extensibility	✔

Attributes

This module does not add product attributes.
Instead, it introduces:

• Custom DB table for AI-generated images
• Admin UI component for image listing
• Filters for:
  • Style
  • Scene
  • Gender

© MHinspeya — All Rights Reserved