Summary

This project provides a visual creation skill for cross-border and domestic e-commerce, automating the generation of a comprehensive suite of visual assets. Targeting e-commerce professionals, marketers, and designers, it streamlines the creation of product main images, detail pages, social media content, and livestream scenes, emphasizing campaign consistency and conversion effectiveness.

How It Works

The system functions as an AI-driven tool that can either produce detailed visual briefs and AI image prompts or directly generate images using an OpenAI-compatible API. Its core innovation lies in the "Campaign Style Lock" mechanism, which enforces visual coherence across multiple images by standardizing color palettes, tones, fonts, lighting, and layout. Additionally, it employs a "conversion-driven" approach, analyzing whether to emphasize product features, address pain points, or evoke emotional value to maximize marketing impact.

Quick Start & Requirements

• Primary install / run command: Clone the repository (git clone https://github.com/liangdabiao/ecom-details-image.git) and navigate into the directory (cd ecom-details-image).
• Non-default prerequisites and dependencies:
  • Python 3.10+
  • An OpenAI-compatible image generation API (e.g., OpenAI, Azure OpenAI, or third-party services).
  • API credentials configured in a .env file (e.g., IMG_BASE_URL, IMG_MODEL, IMG_API_KEY).
  • Optional: Claude Code CLI or similar for interactive natural language prompting.
• Estimated setup time or resource footprint: Setup is quick, involving cloning and API configuration. Image generation costs and performance are dependent on the chosen API provider.
• Links:
  • Project Repository: https://github.com/liangdabiao/ecom-details-image
  • Inspiration: https://github.com/buluslan/gpt-image2-ecommerce, https://github.com/coolqoo/1click-ecom-detailpage

Highlighted Details

• 25 Scene Templates: Offers a comprehensive library covering product hero images, lifestyle shots, detail close-ups, social media content, livestream scenes, and more.
• Campaign Style Lock: Ensures visual consistency across generated image sets by locking color palettes, tones, fonts, backgrounds, and lighting.
• Conversion-Driven Design: Analyzes visual strategy based on product type (visual, pain-point, or emotional value drivers) for targeted marketing.
• Dual Mode Operation: Supports generating detailed visual briefs and prompts, or directly executing image generation via API.
• Reference Image Support: Enables AI to generate product visuals that closely match an uploaded reference product image for consistency.
• Pure Python Generation Script: The core image generation script (generate_image.py) relies solely on Python's standard library, minimizing external dependencies for execution.

Maintenance & Community

No specific details on active contributors, sponsorships, or community channels (e.g., Discord, Slack) are provided in the README.

Licensing & Compatibility

• License type: MIT License.
• Compatibility notes: Permissive MIT license generally allows for commercial use and integration into closed-source projects.

Limitations & Caveats

External API Dependency: Image generation is entirely dependent on an external OpenAI-compatible image generation API, incurring associated costs and performance variability. API Service Variability: Specific features, such as reference image support, may have varying levels of implementation and effectiveness across different API providers.