如何用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 平台提供生成记录自动归档功能,便于企业进行合规管理。