如何用AI做電商詳情頁?Nano Banana Pro API加持四宮格敘事圖生成3大技巧

import openai
import requests
import os
from typing import List， Dict
import json

class NanoBananaProGenerator:
    """Nano Banana Pro API 電商圖片生成器"""

    def __init__（self， api_key: str， base_url: str = "https://api.apiyi.com/v1"）:
        self.client = openai.OpenAI（api_key=api_key， base_url=base_url）

    def generate_ecommerce_grid（
        self，
        product_name: str，
        style_description: str，
        reference_images: List[str] = None，
        resolution: str = "2048x2048"，
        grid_layout: str = "2x2"
    ） -> Dict:
        """
        生成電商四宮格敘事圖

        Args:
            product_name: 產品名稱
            style_description: 風格描述（如"簡約現代"、"奢華典雅"）
            reference_images: 參考圖片URL列表（最多8張）
            resolution: 分辨率 （1024x1024/2048x2048/4096x4096）
            grid_layout: 網格佈局 （2x2/3x3）

        Returns:
            包含圖片URL和元數據的字典
        """

        # 構建提示詞
        prompt = f"""生成一張"{style_description}"風格的{grid_layout}敘事式網格圖片。

產品主體: {product_name}
設計要求:
1. 保持產品外觀完全一致（形狀、顏色、Logo、標籤不變）
2. 四個場景展示不同使用情境或產品細節
3. 統一的光線和色調，符合{style_description}審美
4. 佈局緊湊，畫面平衡，視覺流暢
5. 不添加文字說明或標註

整體風格專業、高端，適合電商詳情頁展示。"""

        try:
            # 調用 API 生成圖片
            response = self.client.images.generate（
                model="nano-banana-pro"，
                prompt=prompt，
                n=1，
                size=resolution，
                response_format="url"
            ）

            result = {
                "success": True，
                "image_url": response.data[0].url，
                "resolution": resolution，
                "prompt": prompt，
                "product": product_name
            }

            return result

        except Exception as e:
            return {
                "success": False，
                "error": str（e），
                "product": product_name
            }

    def batch_generate（
        self，
        products: List[Dict]，
        save_dir: str = "./generated_images"
    ） -> List[Dict]:
        """
        批量生成多個產品的四宮格圖片

        Args:
            products: 產品信息列表，每項包含 name 和 style_description
            save_dir: 保存目錄

        Returns:
            生成結果列表
        """
        os.makedirs（save_dir， exist_ok=True）
        results = []

        for idx， product in enumerate（products， 1）:
            print（f"正在生成 {idx}/{len（products）}: {product['name']}"）

            result = self.generate_ecommerce_grid（
                product_name=product['name']，
                style_description=product.get（'style_description'， '現代簡約'），
                resolution=product.get（'resolution'， '2048x2048'）
            ）

            if result['success']:
                # 下載圖片到本地
                img_response = requests.get（result['image_url']）
                filename = f"{save_dir}/{product['name'].replace（' '， '_'）}.png"

                with open（filename， 'wb'） as f:
                    f.write（img_response.content）

                result['local_path'] = filename
                print（f"✓ 已保存到 {filename}"）
            else:
                print（f"✗ 生成失敗: {result['error']}"）

            results.append（result）

        return results

# 使用示例
if __name__ == "__main__":
    # 初始化生成器
    generator = NanoBananaProGenerator（
        api_key="your_api_key_here"
    ）

    # 定義產品列表
    products = [
        {
            "name": "藍牙耳機-白色款"，
            "style_description": "科技感極簡風格"，
            "resolution": "2048x2048"
        }，
        {
            "name": "保溫杯-商務系列"，
            "style_description": "高端商務風格"，
            "resolution": "2048x2048"
        }
    ]

    # 批量生成
    results = generator.batch_generate（products）

    # 保存生成報告
    with open（"generation_report.json"， "w"， encoding="utf-8"） as f:
        json.dump（results， f， ensure_ascii=False， indent=2）

    print（f"\n完成！ 成功生成 {sum（1 for r in results if r['success']）}/{len（results）} 張圖片"）

這是最常見的問題，通常由以下原因導致:

原因分析:

1. 參考圖質量不足（分辨率低、產品佔比小、背景複雜）
2. 提示詞描述不夠精確，缺少產品關鍵特徵描述
3. 沒有使用否定提示詞排除變化項

解決方案:

• 使用至少 1024×1024 分辨率的產品白底圖作爲主要參考
• 在提示詞中明確列出「不可改變的產品特徵」列表
• 添加否定提示詞: "禁止改變產品的顏色、形狀、Logo、標籤"
• 增加參考圖數量（使用 2-3 張不同角度的產品圖）

如果問題持續，建議通過 API易 apiyi.com 平臺的技術支持獲取提示詞優化建議。

批量生成需要完善的自動化流程:

技術方案:

1. 建立產品信息數據庫（包含產品圖、名稱、類別、風格標籤）
2. 爲不同類別創建提示詞模板
3. 使用併發 API 調用（建議併發數 5-10，避免觸發限流）
4. 實現自動下載、質量檢查和異常重試機制

工具推薦:

• 使用 Python asyncio 庫實現異步批量調用
• 通過 API易 apiyi.com 平臺的批量接口，支持單次提交多個任務
• 配置 Webhook 回調，生成完成後自動通知和下載

根據經驗，合理配置的自動化流程可實現每小時生成 200-500 張圖片的效率。

Nano Banana Pro 內置了文字渲染能力，但需要正確使用:

最佳實踐:

1. 在提示詞中明確指定需要顯示的文字內容和語言
2. 對於品牌名、產品名等關鍵文字，使用英文原文描述
3. 如果需要中文文字，建議分辨率至少選擇 2K
4. 避免在提示詞中要求生成過多文字（建議不超過 20 個字符）

替代方案:
對於需要大量準確文字的場景（如產品規格表、使用說明），建議:

• 先用 Nano Banana Pro 生成無文字的背景圖
• 再通過圖片編輯工具添加文字圖層
• 或在詳情頁用 HTML 文字覆蓋在圖片上方

常見的性能和穩定性問題處理方法:

調用失敗處理:

• 實現重試機制（建議最多重試 3 次，指數退避）
• 檢查 API key 是否有效和餘額是否充足
• 驗證參數格式是否正確（特別是 size 參數）

速度優化:

• 4K 分辨率生成時間通常爲 20-40 秒，2K 爲 10-20 秒，1K 爲 5-10 秒
• 使用併發調用可顯著提升批量生成效率
• 選擇負載較低的時段進行批量任務（建議凌晨 0-6 點）

通過 API易 apiyi.com 平臺調用可獲得更穩定的服務質量保障，平臺提供智能路由和負載均衡，確保高峯期也能保持穩定的生成速度。

這是電商企業最關心的法律問題:

版權歸屬:

• 根據 Google AI 官方政策，用戶擁有生成圖片的使用權
• 可自由用於商業用途，無需支付額外版權費
• 但不能聲稱對 AI 模型本身擁有版權

風險提示:

• 如果提示詞或參考圖涉及他人版權內容（如明星肖像、知名品牌），生成結果可能侵權
• 建議只使用自有產品圖作爲參考
• 對於品牌聯名或授權產品，需提前確認授權範圍

合規建議:

• 保存生成記錄和提示詞，作爲原創證明
• 在詳情頁標註「AI 輔助生成」（可選，部分平臺要求）
• 定期審查生成內容，確保符合平臺規範

API易 apiyi.com 平臺提供生成記錄自動歸檔功能，便於企業進行合規管理。